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ABSTRACT 

BiblioText  is  window-  and  mouse-based  program  for  browsing 
bibliographic  data  and  related  notes.  It  is  designed  for  a  personal  working 
environment  characterized  by  indexed  bibliographic  data  in  bib,  refer,  or 
tib  format,  along  with  online  documents  containing  imprecise  citations 
that  point  into  the  database.  BiblioText  assists  the  writing  of  papers  with 
functions  like  interactive  keyword  lookup  and  automatic  generation  of 
imprecise  citations;  it  also  supports  related  tasks  like  tracking  notes  and 
annotations  in  bibliographic  data,  building  reading  lists  and  annotated 
bibliographies,  and  managing  personal  libraries.  In  an  appropriately 
configured  data  environment,  BiblioText  functions  as  a  hypertext  browser, 
traversing  imprecise  citations  (in  the  manner  of  bib)  and  named  links  in 
the  bibliographic  database  (a  BiblioText  extension). 
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1.  Introduction 

BiblioText  is  an  interactive,  window-  and  mouse-based  program  for  browsing  col¬ 
lections  of  notes,  papers,  and  bibliographic  reference  data.  It  is  a  byproduct  of  ongoing 
research  on  the  design  of  personal  information  management  tools  and  on  issues  in  user 
interface  design.  This  research  is  part  of  the  PIPER  projects  at  UC  Berkeley.  BiblioText 
runs  on  Sun  Workstations2  under  UNIX3  and  Release  3.4  of  the  SunView  window 
manager. 

BiblioText,  in  cooperation  with  other  UNIX  tools,  can  help  with  the  following  tasks 
that  arise  in  many  working  environments: 

•  Keeping  track  of  personal  notes  on  material  already  read; 

•  Building  annotated  bibliographies; 

•  Writing  papers,  including  retrieval  of  relevant  reading  notes,  location  of  important 
references,  and  automatic  insertion  of  citation  strings; 

•  Keeping  track  of  reading  lists,  including  the  management  of  “virtual  piles”  of  papers 
for  later  reading; 

•  Managing  personal  libraries;  and 

•  Sharing  bibliographic  references  and  notes  among  colleagues. 

With  appropriately  configured  data,  BiblioText  can  be  used  as  a  hypertext  browser. 
It  differs  from  other  hypertext  systems  (see  [Con87]  for  a  good  survey)  in  several  impor¬ 
tant  respects. 

1.  BiblioText  is  compatible  with  data  used  by  other  UNIX  tools.  It  operates  on  ordinary 
text  files  and  three  kinds  of  bibliographic  databases. 

2.  BiblioText  is  specialized  for  a  particular  application  area  (keeping  notes,  tracking 
bibliographic  references,  writing  papers,  and  the  like),  and  for  particular  suites  of  text 
processing  tools  (for  example  bib,  troff,  and  your  favorite  text  editor). 

3.  BiblioText  is  read-only.  It  complements  other  tools  for  managing  your  data;  it  does 
not  replace  them. 

This  document  introduces  BiblioText,  describes  how  it  can  fit  into  your  working 
environment,  and  gives  you  enough  information  to  get  started  using  it.  Section  2  (“Why 
BiblioText?”)  begins  with  some  background  and  a  preview  of  what  BiblioText  can  do 
for  you.  A  tutorial  discussion  of  how  you  might  use  BiblioText  in  practice  comes  later, 
in  Section  6  (“How  to  Use  BiblioText”). 

BiblioText  is  only  as  useful  as  your  collected  data;  Section  3  (“How  to  Organize 
Your  Data  for  BiblioText”)  introduces  basic  organizational  techniques.  The  discussion 
in  Section  6  (“How  to  Use  BiblioText”)  suggests  how  to  use  these  techniques  for  max¬ 
imum  advantage. 

BiblioText  allows  considerable  latitude  in  your  organizational  methods,  and  you 
will  need  to  configure  the  program  to  reflect  your  particular  approach;  section  4  (“How 
to  Configure  BiblioText  for  Your  Data”)  contains  the  details. 


2  Sun  Workstation  and  Sun  View  are  registered  trademarks  of  Sun  Microsystems,  Inc. 

3  UNIX  is  a  registered  trademark  of  AT&T  Bell  Laboratories  in  the  USA  and  other  countries. 
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Finally,  Section  5  (“How  BiblioText  Works”)  describes  BiblioText’s  functional 
characteristics,  and  complements  the  discussion  in  Section  6  (“How  to  Use 
BiblioText”). 

For  completeness,  this  document  mentions  minor  points  about  BiblioText  and  its 
use.  These  appear  in  special  paragraphs,  set  in  a  smaller  typefont,  as  in  the  following. 
Feel  free  to  skip  these  during  a  first  reading. 

BiblioText’s  man  page  summarizes  much  of  the  material  presented  in  Sections  4  and  5. 


2.  Why  BiblioText? 

BiblioText  was  designed  for  a  specific  niche  in  personal  working  environments;  it 
complements  existing  tools  and  existing  data  in  support  of  certain  kinds  of  work.  This 
section  supplies  a  bit  of  background  on  BiblioText’s  intended  environment,  and  discusses 
the  approach  taken  in  its  design. 

Information-Based  Working  Environment 

BiblioText  was  designed  for  an  information-based  working  environment,  where 
people  read  documents,  write  documents,  and  (whether  they  realize  it  or  not)  build  com¬ 
plex  webs  of  documents,  notes,  and  bibliographic  reference  data.  Some  of  these  docu¬ 
ments  are  in  online  computer  files.  Other  documents  are  not  online,  but  might  be  anno¬ 
tated,  tracked,  and  cited  using  online  files.  In  this  environment,  people  spend  their  time 
on  tasks  such  as  the  following: 

•  Reading  Documents.  Some  are  physical  documents,  others  arrive  electronically. 
Some  documents  must  first  be  located  physically,  based  perhaps  on  a  reference  in 
another  document  or  on  the  recommendation  of  a  colleague. 

•  Taking  Notes.  Note  taking  is  often  an  important  part  of  reading.  Some  notes  become 
part  of  the  document  (as  with  marginal  notes  in  a  book),  while  some  reside  elsewhere 
(in  a  notebook,  for  example).  When  document  and  notes  are  separate,  it  is  sometimes 
necessary  to  locate  one,  given  the  other. 

•  Building  Piles  of  Documents.  There  are  often  more  documents  to  read  than  time  per¬ 
mits.  The  standard  solution  (and  an  effective  one  in  many  situations  [Mal82])  is  to 
stack  them  in  piles.  Piles,  sorted  perhaps  by  subject  or  project,  are  visual  reminders 
and  provide  a  convenient  access  mechanism  for  possible  later  reading. 

•  Writing  Papers.  Authors,  as  they  work,  may  refer  to  documents  they  have  read  earlier, 
although  it  often  isn’t  clear  in  advance  which  documents  will  be  needed.  If  separate 
notes  are  available,  those  may  be  needed  too.  An  important  part  of  this  task  is  deter¬ 
mining  which  documents  and  notes  are  relevant  at  any  given  moment.  Bibliographic 
descriptions  of  some  documents  may  be  copied  into  the  paper’s  reference  list  and  cita¬ 
tions  inserted  appropriately. 

•  Managing  A  Library.  People  own  personal  copies  of  documents,  although  many 
remain  unread.  These  include  books,  journals,  conference  proceedings,  photocopies, 
course  notes,  and  numerous  loose  ends.  Finding  specific  documents  can  be  difficult, 
especially  when  they  might  reside  in  various  piles  or  may  have  been  lent  to  col¬ 
leagues. 
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•  Sharing  Information.  Groups  of  colleagues  usually  circulate  copies  of  documents 
among  themselves,  and  they  may  also  share  online  information  in  some  way. 

Stepping  back  from  this  description  for  a  moment,  the  information  structure  in 
which  this  working  environment  is  embedded  resembles  hypertext.  Documents  cite  other 
documents,  documents  refer  to  notes,  notes  refer  to  documents,  lists  (the  online 
equivalent  of  piles)  refer  to  documents,  and  colleagues  refer  to  documents  in  communi¬ 
cation  with  one  another. 

Automated  Tools 

Computer  based  tools  for  personal  information  management  are  becoming  more 
common.  These  usually  include,  among  others,  document  processing  tools  such  as  text 
editors  (like  vi[Joy79]  and  emacs[St2&\\),  document  typesetting  programs  (like 
troff [Oss76]  and  7eX[Knu84]),  bibliographic  database  preprocessors  for  documents  (like 
re/i?r[Les80],  Wfc[BuL82],  and  ft'6[Ale86]),  and  file  systems  that  underly  everything  (like 
the  one  in  UNIX). 

With  some  ingenuity  and  initiative,  these  tools  can  be  brought  to  bear  on  the  tasks 
described  above.  They  form  a  loose  confederation,  however,  and  getting  them  to  work  in 
concert  can  present  unpleasant  technical  obstacles.  The  problem  is  that  tools  are  gen¬ 
erally  built  around  their  functionality,  what  they  do,  as  opposed  to  how  they  might  be 
used.  This  is  the  advantage  of  the  toolkit  approach  to  automated  tools,  but  it  puts  the 
burden  on  the  individual  to  create  a  convenient  personal  working  environment  that  will 
earn  its  keep  (that  is,  be  worth  the  trouble  of  putting  it  together). 

Even  more  troublesome  is  the  observation  that,  for  some  of  the  tasks  described 
above,  the  trouble  of  maintaining  the  information  online  is  simply  too  great  to  justify  use 
by  one  person.  Sharing,  on  the  other  hand,  requires  that  personal  working  environments 
not  be  completely  incompatible  with  one  another. 

Workstations 

Workstation  technology  can  help.  It  makes  available  more  computing  power,  sup¬ 
ports  better  user  interfaces,  and  enables  better  integration  among  different  tools. 

Tool  integration  in  practice,  however,  is  too  often  limited  to  cut-and-paste.  This 
mechanism  permits  text  selected  from  one  application  to  be  inserted  into  another,  but 
even  this  seldom  works  as  generally  as  one  would  like. 

Tools  are  being  developed  that  take  better  advantage  of  workstation  technology,  for 
example  hypertext  systems  like  NoteCards[HMT87]  and  Hypercard[Goo87].  These 
advanced  systems  tend  to  be  monolithic,  however,  and  are  often  detached  completely 
from  existing  working  environments.  This  presents  the  potential  user  with  a  dilemma. 

•  Monolithic  systems  seldom  work  with  existing  data  (documents,  bibliographic  data¬ 
bases,  etc.). 

•  Monolithic  systems  may  not  support  all  the  functionality  to  which  users  have  become 
accustomed.  This  is  especially  true  for  users  who  add  personal  components  to  groups 
of  batch  tools. 

•  Monolithic  systems  tend  to  make  data  accessible  only  through  the  workstation  inter¬ 
face,  excluding  access  with  standard  terminals  over  dialup  lines,  for  example. 
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Where  BiblioText  Fits 

BiblioText  is  designed  for  information-based  working  environments.  Potential 
users  already  have  data  and  personal  tools  built  around  suites  of  batch  programs  for  this 
kind  of  management  (in  particular,  with  data  suitable  for  troff,  bib,  TeX,  tib,  and  the  like), 
and  they  want  to  take  advantage  of  workstation  technology  for  enhanced  access  to  that 
data. 

BiblioText  is  a  browser,  a  tool  that  permits  inspection  of  data,  without  requiring  that 
its  users  understand  the  structure  of  the  data  at  every  turn.  BiblioText  is  a  workstation 
program,  using  bitmapped  graphics  and  the  mouse  to  support  a  quick  and  convenient  user 
interface.  BiblioText  is  compatible  with  existing  tools,  allowing  navigation  through  data 
maintained  with  other  programs.  Although  BiblioText  is  general,  in  the  sense  that  it 
operates  over  data  shared  with  many  other  tools,  it  is  also  specialized  for  the  kinds  of 
tasks  described  above.  In  particular,  BiblioText  is  designed  to  bind  together  this  working 
environment,  and  to  make  explicit  and  accessible  those  hypertext-like  aspects  of  a  per¬ 
sonal  working  environment  that  are  not  visible  through  existing,  individual  tools. 


3.  How  to  Organize  Your  Data  for  BiblioText 

BiblioText  is  a  browser  for  data  shared  with  other  tools.  This  section  describes  the 
data  domain  over  which  BiblioText  can  operate,  and  discusses  some  of  the  basic  organi¬ 
zational  techniques  for  data  that  make  BiblioText  useful. 

Like  the  tools  it  complements,  BiblioText  permits  many  degrees  of  freedom  in  your 
data  organization.  You  will  want  to  configure  your  environment  to  suit  your  personal 
needs.  The  discussion  here  emphasizes  how  to  make  the  tools  work.  Section  6  (“How  to 
Use  BiblioText”)  complements  this  discussion  by  suggesting  how  you  might  adapt  these 
organizational  techniques  to  your  particular  needs. 

BiblioText  operates  over  a  data  domain  that  contains  two  types  of  objects:  biblio¬ 
graphic  databases  and  online  documents.  This  section  discusses  the  the  two  data  areas  in 
turn,  with  a  final  note  about  sharing. 

3.1.  Bibliographic  Databases 

The  backbone  of  BiblioText’s  data  environment  is  a  bibliographic  database,  which 
you  manage  using  any  of  several  suites  of  tools  designed  for  just  this  purpose. 
BiblioText  is  compatible  with  database  formats  used  by  refer[Les80],  fci'b[BuL82],  and 
rih[Ale86].  For  simplicity,  this  discussion  presumes  the  use  of  bib,  unless  specifically 
mentioned  otherwise. 

Raw  Refs. 

In  every  database  format  the  basic  unit  of  data  is  the  bibliographic  reference  (shor¬ 
tened,  in  BiblioText  terminology,  to  ref.).  A  ref.  is  just  a  description,  in  bibliographic 
format,  of  something  else.  The  something  else  being  described  could  be  a  physical  docu¬ 
ment  (such  as  a  book),  part  of  physical  document  (such  as  an  article  from  conference 
proceedings),  another  online  document,  or  anything  else  that  you  want  to  manage,  track, 
cite,  or  locate. 
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Using  a  text  editor,  you  add  refs,  to  your  database  in  raw  form,  as  lines  of  text 
separated  by  blank  lines.  For  example,  the  following  raw  ref.  in  bib  format  describes  a 
paper  delivered  at  a  conference: 


%A  Douglas  C.  Engelbart 
%A  William  K.  English 

%T  A  Research  Center  for  Augmenting  Human  Intellect 
%J  FJCC 
%P  395-410 
%D  1968 


Each  line  of  the  raw  ref.  contains  a  field,  identified  by  a  label  (sometimes  called  a  key) 
like  %A  and  %T.  See  the  relevant  documentation  for  a  more  detailed  description  of  the 
various  raw  formats;  all  are  similar.  The  conventional  file  name  extension  for  raw  refs, 
in  bib  format  is  .ref.  A  typical  bibliographic  database  includes  many  files  of  raw  refs., 
both  to  avoid  unmanageably  long  files  and  to  add  useful  structure  to  the  database. 

An  important  aspect  of  the  raw  ref.  representation  is  that  all  fields  need  not  be 
recognized  by  all  tools.  Each  bibliographic  format  defines  a  standard  group  of  fields,  but 
other  tools  are  free  to  use  undefined  fields  with  the  confidence  that  existing  tools  will 
simply  ignore  data  in  such  fields.  BiblioText  takes  advantage  of  this  freedom  and  allows 
you  to  specify  that  certain  fields  in  your  data  be  recognized  as  links  between  refs,  and 
other  refs,  or  between  refs,  and  files  (more  on  links  later). 

Abbreviations 

Bibliographic  databases  in  bib  and  tib  format  make  use  of  macro  expansion  (or 
abbreviation),  although  the  two  systems  define  expansion  a  bit  differently.  This  mechan¬ 
ism  can  buy  a  certain  amount  of  compactness  and  uniformity.  In  the  above  example 
“FJCC”  is  just  an  abbreviation  for  “Fall  Joint  Computer  Conference.” 

A  typical  bibliographic  database  may  include  several  files  of  definitions.  The  exact 
format  is  beyond  the  scope  of  this  introduction;  consult  the  relevant  database  documenta¬ 
tion  for  details.  It  is  possible,  and  sometimes  useful,  to  provide  your  own  additional 
definitions. 

The  document  preprocessors  for  bib  and  tib  support  varying  reference  formatting 
styles  that,  among  other  things,  include  alternate  sets  of  definitions  for  macros.  By  con¬ 
vention,  some  sets  of  definitions  are  short  (or  abbreviated),  some  are  full,  and  some  are 
used  for  both.  An  abbreviated  definition  for  "FJCC”  in  the  above  example  might  be  “Fall 
Joint  Comp.  Conf.”  BiblioText  mirrors  this  usage  with  the  Verbose  Display  viewing 
mode.  When  you  create  your  own  macro  definitions,  you  may  specify  that  they  be  used 
for  verbose  viewing  only,  for  terse  (non-verbose)  viewing  only,  or  for  both. 

Indexing 

Most  tools  that  read  raw  refs,  (including  document  preprocessors  and  BiblioText) 
require  the  presence  of  indexes.  Each  is  an  inverted  keyword  index  to  one  more  more 
files  of  raw  refs.,  as  described  originally  in  [Les80].  It  is  usually  necessary  to  rebuild  an 
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index  when  any  of  its  files  of  raw  refs,  changes. 

The  programs  for  building  indexes  are  invert  (for  bib  databases),  indxbib  (for  refer 
databases),  and  tibdex  (for  tib  databases).  Most  allow  you  to  select  which  fields  to  use 
for  indexing;  consult  the  appropriate  documentation  for  details. 

It  is  an  especially  good  idea  to  exclude  from  indexing  any  fields  that  you  are  using  as 
links  (see  discussion  of  links  below). 

The  conventional  (and  default)  file  name  for  an  index  is  simply  INDEX.  A  common 
organization  for  raw  ref.  files  has  them  grouped  into  directories,  with  a  single  index  for 
each  directory.  A  particularly  helpful  technique  for  keeping  an  index  current  is  to  use 
make{Fe\19 ]  with  entries  something  like  the  following: 


all:  INDEX 

INDEX:  *.ref 

invert  *.ref 


Additional  Keywords 

Bibliographic  formats  usually  reserve  the  %K  field  for  additional  keywords ,  words 
added  to  a  raw  ref.  only  for  indexing.  One  common  use  for  additional  keywords  is  to 
associate  a  ref.  with  a  subject,  when  the  subject  is  not  evident  from  the  title.  For  exam¬ 
ple,  you  might  add  keywords  to  the  example  ref.  as  follows: 


%A  Douglas  C.  Engelbart 
%A  William  K.  English 

%T  A  Research  Center  for  Augmenting  Human  Intellect 
%J  FJCC 
%P  395-410 
%D  1968 

%K  hypertext  mouse  chord  keyboard 


Annotation 

An  essential  part  of  any  personal  information  management  is  annotation. 
BiblioText  supports  two  annotation  mechanisms  for  bibliographic  data:  inline  annota¬ 
tions  (discussed  here)  and  links  (discussed  below). 

Most  bibliographic  database  formats  reserve  the  %X  field  for  inline  annotations, 
even  though  none  of  the  standard  tools  support  this  field  directly.  Inline  annotations  are 
short  bits  of  text,  included  with  the  raw  ref.  file,  in  which  you  can  add  anything  you  wish. 
For  example,  you  might  annotate  the  example  ref.  as  follows: 
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%A  Douglas  C.  Engelbart 
%A  William  K.  English 

%T  A  Research  Center  for  Augmenting  Human  Intellect 
%J  FJCC 
%P  395-410 
%D  1968 

%K  hypertext  mouse  chord  keyboard 

%X  seminal  paper,  accompanied  by  astounding  demo 


BiblioText  explicitly  supports  the  %X  field.  The  contents  of  %X  fields  appear  when 
Verbose  Display  mode  is  on,  but  are  elided  when  it  is  off.  Inline  annotations  are  most 
convenient  for  short  notes,  containing  one  to  twenty  lines  of  text. 

Links 

BiblioText  provides  a  powerful  annotation  mechanism  as  an  extension  to  the  basic 
bibliographic  data  format.  You  may  place  any  number  of  links  in  each  raw  ref.,  based  on 
field  labels  you  have  defined  for  this  purpose.  A  link  points  to  another  ref.  or  to  an  exter¬ 
nal  file  (outside  of  the  bibliographic  database  proper).  Links  of  the  former  type  are  called 
cite  links,  those  of  the  latter  are  called  file  links.  BiblioText  supports  rapid  traversal  of 
these  links  during  browsing  sessions. 

For  example,  you  might  have  specified  in  your  environment  that  %Y  fields  contain 
cite  links  and  that  %Z  fields  contain  file  links.  Using  links,  you  might  further  annotate 
the  example  ref.  as  follows: 

%A  Douglas  C.  Engelbart 
%A  William  K.  English 

%T  A  Research  Center  for  Augmenting  Human  Intellect 
%J  FJCC 
%P  395-410 
%D  1968 

%K  hypertext  mouse  chord  keyboard 

%X  seminal  paper,  accompanied  by  astounding  demo 

%Y  "conceptual  framework  paper"  engelbart  conceptual  framework  1963 

%Z  notes  note/Engelbart68.ms 

A  link  field  of  either  type  must  contain  a  name  (which  need  only  be  quoted  if  it  contains 
embedded  white  space)  followed  by  a  value  that  describes  the  target  of  the  link. 
BiblioText  displays  the  names  of  links  in  a  format  something  like  the  following: 


<conceptual  framework  paper><notes> 


A  single  ref.  may  contain  any  number  of  links  of  either  kind,  but  they  should  be  named 
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uniquely  to  avoid  confusion  during  browsing. 

The  value  of  a  cite  link  is  a  collection  of  keywords  that  presumably  identifies 
another  ref.  uniquely  (much  like  an  imprecise  citation  in  your  bib  documents).  These 
links  might  point  to  alternate  versions  of  a  paper,  a  collection  in  which  the  ref.  was 
reprinted,  or  whatever  else  you  choose. 

It  is  an  especially  good  idea  to  exclude  from  indexing  any  fields  you  are  using  as  links. 

Otherwise,  cite  links  would  be  inherently  self  referential. 

The  value  of  a  file  link  is  simply  the  name  of  a  file.  If  the  file  name  does  not  begin 
with  a  “/”,  BiblioText  interprets  the  file  name  relative  to  the  directory  in  which  the  raw 
ref.  resides.  These  links  might  point  to  files  in  which  you  have  written  extended  notes 
about  the  ref.  (cf.  “Inline  Annotations”  above),  or  to  the  document  described  by  the  ref., 
if  it  happens  to  be  online. 

However  you  choose  to  use  file  links,  the  files  to  which  they  point  are  generally  just 
instances  of  documents ,  the  subject  of  the  next  section. 

3.2.  Documents 

From  the  point  of  view  of  BiblioText,  a  document  is  any  text  file  that  is  not  part  of 
your  bibliographic  database  proper.  You  may  organize  them  in  any  way.  In  many  cases 
they  will  be  written  for  typesetting  with  bib/troff(ot  tib/TeX).  Some  might  be  papers  you 
are  writing  or  have  written,  others  might  be  reviews  of  documents  you  have  read,  still 
others  might  be  fragmentary  working  notes. 

Citations 

The  one  structural  feature  of  documents  relevant  to  BiblioText  is  the  presence  of 
imprecise  citations,  as  defined  by  the  document  preprocessor  bib  (or  tib  or  refer  respec¬ 
tively).  An  imprecise  citation  is  a  specially  delimited  string  of  keywords  that  uniquely 
identify  a  particular  ref.  from  your  database.  For  example,  a  document  might  cite  the 
example  ref.  as  follows: 

...  demonstrated  first  by  Doug  Engelbart  during  his 
memorable  1968  appearance  at  the  Fall  Joint  Computer 
Conference  [.engelbart  english  1968.]. 

This  citation  allows  your  document  preprocessor  to  create  a  suitable  citation  at  this  point 
in  the  text  and  to  add  the  ref.  to  the  references  list  at  the  end  of  the  document. 

During  a  browsing  session,  an  imprecise  citation  is  just  another  kind  of  cite  link, 
pointing  from  a  document  to  a  ref.  (cf.  cite  links  that  point  from  a  ref.  to  another  ref., 
discussed  previously  under  “Links”).  When  you  examine  the  text  file  containing  this 
document,  you  can  use  BiblioText  to  follow  the  citation  (link)  to  the  ref.  to  which  it 
refers. 
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Hidden  Citations 

Although  most  citations  in  your  documents  will  be  of  the  ordinary  sort,  as  demon¬ 
strated  above,  there  are  some  useful  variations.  In  particular,  you  can  add  citations  that 
are  hidden ,  either  from  the  document  typesetter,  or  from  both  the  bibliographic  prepro¬ 
cessor  and  typesetter. 

Most  document  typesetters  allow  embedded  comments,  text  in  the  source  file  that 
does  not  appear  the  typeset  result.  One  might  insert  an  imprecise  citation  in  such  a  com¬ 
ment;  in  troff  this  would  appear  as: 

A"  [.engelbart  english  1968.] 

This  citation  is  visible  to  the  bibliographic  preprocessor  (bib),  so  that  the  cited  ref.  would 
appear  in  the  paper’s  reference  list.  However,  the  citation  itself  would  not  appear  in  the 
typeset  document.  While  browsing  the  source  file  containing  a  hidden  citation,  you  can 
use  BiblioText  to  follow  the  citation  to  the  intended  ref. 

It  is  also  possible  to  hide  a  citation  from  both  typesetter  and  bibliographic  prepro¬ 
cessor,  simply  by  avoiding  the  special  delimiters  that  mark  normal  imprecise  citations. 
One  way  to  do  this  in  troff  might  be  as  follows: 

A"  Review  [engelbart  english  1 968]  on  this  point. 

Here  no  mention  of  the  cited  ref.  would  appear  in  the  typeset  document,  but  the  comment 
would  be  visible  to  the  reader  of  the  source  text,  and  the  link  would  be  suggested  by  the 
square  brackets.  As  before,  while  browsing  this  file,  you  can  use  BiblioText  to  follow 
the  citation  to  the  intended  ref. 

Section  6  (“How  to  Use  BiblioText”)  contains  a  more  thorough  discussion  of  how 
hidden  citations  might  be  useful. 

3.3.  Sharing 

Although  most  BiblioText  users  will  only  have  one  bibliographic  database  (typi¬ 
cally  a  directory  of  raw  ref.  files  and  a  single  index),  there  is  much  to  be  gained  by  shar¬ 
ing  databases  with  colleagues. 

Sharing  Personal  Databases 

BiblioText  can  be  operate  over  multiple  bibliographic  databases;  all  that  is  required 
(other  then  the  appropriate  configuration)  is  read-access  to  the  files.  Browsing  opera¬ 
tions,  such  as  keyword  searches,  then  proceed  sequentially  through  all  the  indexes  you 
have  active  at  the  time.  This  can  be  an  effective  way  to  share  information  among  a  group 
of  people  with  overlapping  interests.  There  is  no  risk  to  private  data,  since  BiblioText 
does  not  modify  data  in  the  bibliographic  databases  it  reads. 

You  may  prefer  to  keep  some  data  private,  certain  files  of  notes  pointed  to  by  file 
links,  for  example.  You  can  limit  access  to  some  data  using  file  permissions,  without 
denying  access  to  the  bibliographic  database  in  general. 

A  weakness  of  the  bib  data  model  becomes  clear  when  databases  are  shared.  A  user  who 
wishes  to  write  notes  about  a  reference  mentioned  in  a  colleague’s  database  must  make  a 
personal  copy  of  the  ref.  data  so  that  the  notes  (inline  or  as  a  file  link)  can  be  added. 
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There  are  now  two  copies  of  the  ref.  data  for  the  same  document,  but  BiblioText  cannot 
discover  their  common  ancestry. 

Multiple  Indexing 

Some  groups  maintain,  among  their  communal  resources,  shared  bibliographic 
reference  data,  maintained  in  special  directories  with  their  own  indexes.  These  might 
include,  among  others,  tables  of  contents  for  journals  and  conference  proceedings  of 
common  interest  You  can  effectively  append  shared  databases  to  your  own  by  adding 
these  indexes  to  your  list  for  browsing  (and  document  preprocessing). 

You  may  wish  to  be  more  selective  as  you  include  communal  data  in  your  personal 
environment.  For  example,  in  your  personal  directory  of  reference  data  you  can  create 
file  system  links  to  selected  files  of  shared  reference  data;  the  linked  files  then  appear  in 
your  private  index  as  well  as  in  the  shared  one.  BiblioText,  when  browsing,  filters  out 
this  redundancy  by  refusing  to  add  to  the  collection  any  reference  that  is  already  present, 
independent  of  how  it  was  indexed. 

Importing  Reference  Data 

You  can  extend  the  scope  of  your  bibliographic  databases  by  importing  reference 
data  from  external  sources.  One  source  would  be  various  kinds  of  document  distribution 
lists  (departmental  technical  reports,  for  example),  delivered  online  and  converted 
automatically  to  bib  format.  Another  possibility  is  the  capture  (and  conversion)  of 
bibliographic  data  resulting  from  queries  to  large  online  systems,  such  as  library  catalo¬ 
gues  or  commercial  bibliographic  services.  As  an  example  of  the  latter,  the  BibIX  sys¬ 
tem  (a  variant  of  bib  developed  for  a  medical  community  [RGF87])  includes  tools  for 
converting  the  results  of  online  MEDLINE  searches  into  bib  format. 


4,  How  to  Configure  BiblioText  for  Your  Data 

You  will  need  to  configure  BiblioText  to  operate  in  your  personal  data  environment. 
If  you  supply  no  configuration  information  at  all,  BiblioText  will  be  able  to  examine  only 
the  default  bibliography  of  UNIX  papers  indexed  in  the  file  /usr/dict/papers/INDEX. 

When  you  invoke  BiblioText,  you  may  supply  command  line  arguments  for  the 
SunView  window  manager.  These  “generic  tool  arguments”  specify  initial  window 
position,  size,  and  the  like,  and  are  documented  in  the  man  page  for  suntools. 

Other  than  generic  tool  arguments,  all  configuration  information  for  BiblioText 
comes  from  the  SunView  defaults  database.  You  can  inspect  and  change  the  contents  of 
this  database  by  running  the  SunView  program  defaultsedit  (introduced  in  [SSS86],  and 
described  more  fully  in  its  man  page).  The  remainder  of  this  section  explains  how  to  use 
defaultsedit  to  configure  BiblioText  for  the  data  environment  in  which  you  wish  to 
browse. 
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4.1.  The  Defaults  Database 

For  BiblioText  to  run  at  all,  the  SunView  defaults  database  must  contain 
BiblioText’s  default  configuration.  This  is  supplied  by  the  file  BiblioText.d,  normally 
installed  in  the  directory  /usr/lib/defaults. 

Furthermore,  the  SunView  defaults  database  manager  must  be  appropriately 
configured  to  make  use  of  this  information.  To  check  this,  run  defaultsedit,  select  the 
category  Defaults,  and  be  sure  that  the  option  Private_only  is  set  to  False. 

If  you  do  not  wish  to  install  BiblioText.d  in  the  directory  /usr/local/defaults,  you  may 
adopt  an  alternate  configuration  for  the  defaults  database  manager.  Create  a  new  direc¬ 
tory,  say  /users/mlvdv/lib/defaults.  Install  BiblioText.d  in  that  directory,  along  with  a  soft 
link  to  every  file  that  resides  in  /usr/local/defaults.  Finally,  run  defaultsedit ,  select  the 
Defaults  category,  and  set  the  Directory  option  to  the  new  directory 
/users/mlvdv/lib/defaults.  You  may  have  to  restart  defaultsedit  to  manipulate  this  new 
directory. 

Once  the  SunView  defaults  database  manager  knows  about  BiblioText,  you  may  run 
defaultsedit  and  the  entry  BiblioText  will  appear  in  the  menu  of  categories.  Select  this 
category  and  set  the  options  you  desire,  as  explained  in  the  remainder  of  this  section. 

4.2.  Indexes 

BiblioText  needs  descriptions  of  your  bibliographic  indexes.  These  are  indexes 
built  with  invert  (or  indxbib  or  tibdex  respectively),  as  discussed  in  section  3  (“How  to 
Organize  Your  Data  for  BiblioText”). 

BiblioText  can  browse  as  many  as  twenty  indexes.  In  the  defaults  database  these 
are  named  Indexl  through  Index20.  Defaultsedit  presents  you  with  five  options  for  each 
index: 

•  Use.  BiblioText  queries  the  defaults  database  when  it  starts  and  loads  information 
about  only  those  indexes  for  which  this  option  is  True.  Set  this  option  to  True  when 
you  describe  a  new  index  you  would  like  to  browse.  When  this  option  is  False, 
BiblioText  ignores  the  index  completely,  even  if  it  is  fully  described  by  its  other 
options.  In  the  defaults  database  this  option  is  initially  True  for  Indexl  and  False  for 
Index2  through  Index20. 

•  Menu  Name.  This  option  contains  a  string  by  which  BiblioText  will  refer  to  the  index 
when  communicating  with  you,  the  user.  Set  it  to  a  name  that  will  allow  you  to  iden¬ 
tify  the  particular  index  at  a  glance.  For  example,  the  standard  default  name  for 
Indexl  is  “UNIX  index”. 

•  FileName.  This  option  contains  the  fully  specified  name  of  the  file  that  is  the  index. 
For  example,  the  standard  default  for  Indexl  is  the  file  /usr/dict/papers/INDEX. 

•  KeyLength.  The  program  invert  truncates  useful  keywords  to  some  maximum  length 
when  it  builds  an  index,  specified  with  a  command  line  option.  If  you  build  an  index 
with  a  maximum  key  length  other  than  invert's  default,  which  is  6,  you  should  specify 
that  same  value  in  this  option.  The  default  value  for  this  option  is  also  6,  so  in  the 
normal  case  you  need  not  specify  it. 
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•  Select.  Set  this  option  to  True  if  you  wish  an  index  to  be  active  when  BiblioText 
starts;  otherwise  set  it  to  False.  Once  BiblioText  is  running,  you  may  use  the 
Set  Index  command  at  any  time  to  make  individual  indexes  active  or  inactive  (more 
about  this  in  the  next  section). 

You  may  safely  rebuild  an  active  index  while  BiblioText  is  running.  Just  be  sure  to  wait 
for  invert  to  finish  before  starting  any  BiblioText  operations  that  might  attempt  to  read 
the  index. 

4.3.  Abbreviations 

The  document  preprocessors  bib  and  tib  expand  abbreviated  words  with  macro 
facilities;  they  expand  macros  using  either  short  or  long  expansions  for  the  abbreviated 
words,  depending  on  the  user’s  choice  of  bibliographic  style.  BiblioText  supports  the 
same  macro  expansion  facility  during  browsing,  but  allows  a  bit  more  flexibility  in 
configuration. 

The  macro  expansion  mechanisms  of  the  two  preprocessors  differ  slightly,  and 
BiblioText  can  operate  in  either  manner.  Specify  which  expansion  technique  to  use  with 
the  following  option: 

•  Defs/Style.  Set  this  option  to  Bib  if  you  use  bib- style  macros;  this  expansion  style 
replaces  all  occurrences  of  the  macro  names,  as  long  as  they  are  delimited  by  spaces 
or  punctuation  marks.  Set  this  option  to  Tib  if  you  use  rih-style  macros;  this  expansion 
style  replaces  only  those  names  delimited  by  vertical  bars. 

In  both  cases,  macro  expansion  is  recursive. 

Mixing  definitions  of  the  two  styles  during  browsing  results  in  nothing  worse  than  incom¬ 
plete  or  inelegant  formatting  of  refs,  in  BiblioText’s  viewer. 

You  may  describe  as  many  as  eight  files  containing  macro  definitions  (also  called 
abbreviations  in  this  document).  In  the  defaults  database  these  are  named  Defsl  through 
Defs8.  BiblioText  reads  these  files  when  it  starts  and  builds  a  table  of  definitions  for  use 
by  the  viewer.  Defaultsedit  presents  you  with  three  options  for  each  file: 

•  MenuName.  One  of  BiblioText’s  minor  commands  allows  you  to  browse  the  files  of 
macro  definitions  currently  in  use.  This  option  contains  a  string  by  which  BiblioText 
will  refer  to  this  file  when  the  macro  definition  browser  appears.  Set  it  to  a  short  name 
that  will  allow  you  to  identify  this  particular  file  at  a  glance. 

•  FileName.  This  option  contains  the  fully  specified  name  of  the  macro  definition  file. 

•  Mode.  BiblioText’s  table  of  definitions  allows  two  potentially  different  definitions  for 
each  macro:  a  short  one  (for  terse  display  when  Verbose  Display  mode  is  off)  and  a 
long  one  (when  Verbose  Display  mode  is  on).  This  option  tells  BiblioText  to  treat 
each  file  in  one  of  three  ways:  Terse,  Verbose,  or  Both. 

The  standard  defaults  specify  the  two  macro  files  normally  used  by  bib: 
/usr/new/lib/bmac/bibmacs/bibinc.shortnames  when  Verbose  Display  mode  is  off,  and 
/usr/new/lib/bmac/bibmacs/bibinc.fullnames  when  Verbose  Display  mode  is  on. 

BiblioText  ignores  the  “I”  operator  in  macro  definition  files.  This  operator,  which 
specifies  inclusion  of  other  macro  definition  files,  is  rendered  unnecessary  by  the  defaults 
database. 
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BiblioText  builds  its  dictionary  by  reading  the  macro  files  in  order.  Duplicate  definitions 
replace  earlier  ones.  If  a  macro  has  been  defined  with  both  Verbose  and  Terse 
definitions,  a  later  Both  mode  definition  will  replace  both  earlier  definitions.  If  a  macro 
has  been  defined  with  a  Both  mode  definition,  a  later  Verbose  definition  will  leave  the 
earlier  Terse  definition  (and  conversely  for  a  Terse  definition). 

4.4.  Links 

BiblioText  extends  the  basic  bibliographic  data  format  by  allowing  you  to  insert 
links  into  raw  reference  data.  BiblioText  announces  the  presence  of  any  links  when  it 
formats  a  ref.  for  viewing,  and  makes  available  a  convenient  mechanism  for  traversing 
them. 

You  may  reserve  as  many  as  five  field  labels  for  use  as  links  in  your  data.  In  the 
defaults  database  these  are  named  Linkl  through  Link5.  BiblioText  sets  aside  the  fields 
you  specify  and  uses  them  for  no  other  purpose.  Defaultsedit  presents  you  with  three 
options  for  each  potential  link: 

•  Use.  BiblioText  queries  the  defaults  database  when  it  starts  and  sets  aside  for  linking 
only  those  specifications  for  which  this  option  is  True.  When  this  option  is  False, 
BiblioText  does  not  treat  the  link  specially,  even  if  it  is  fully  described  by  the  other 
two  options.  This  option  is  initially  True  for  Linkl  and  Link2. 

•  Key.  This  option  contains  a  single  character  that  labels  the  field  you  wish  to  set  aside 
for  linking.  This  option  is  initially  “Y”  for  Linkl  and  “Z"  for  Link2. 

•  Type.  This  option  specifies  which  kind  of  link  traversal  BiblioText  should  use  when 
requested  by  the  user.  Set  this  option  to  Cite  when  the  value  of  the  link  field  should  be 
treated  as  an  imprecise  citation,  referring  to  another  ref.  in  the  bibliographic  database. 
Set  this  option  to  File  when  the  value  of  the  link  field  should  be  treated  as  a  file  name, 
referring  to  a  document  that  is  not  part  of  the  bibliographic  database  proper.  This 
option  is  initially  Cite  for  Linkl  and  File  for  Link2. 

The  net  effect  of  the  default  link  specification  is  to  set  aside  two  fields  for  use  as  links.  If 
you  make  no  additional  link  specifications,  BiblioText  treats  %Y  fields  in  your  data  as 
cite  links,  and  %Z  fields  as  file  links. 

If  you  request  a  predefined  field  for  a  link,  the  role  of  the  field  as  link  supersedes  its  other 
uses.  Thus  it  is  best  to  avoid  fields  like  %A  and  %T  for  your  links. 


4.5.  Misc.  Options 

Defaultsedit  presents  you  with  three  other  miscellaneous  options  for  configuring 

BiblioText. 

•  VerboseMode.  Set  this  option  to  True  if  you  wish  BiblioText  to  start  with  its  viewer 
in  Verbose  Display  mode;  otherwise  set  it  to  False  (the  default).  Once  BiblioText  is 
running,  you  may  change  the  mode  at  any  time  with  a  panel  control.  Section  5 
(“How  BiblioText  Works”)  explains  the  effects  of  this  mode. 

•  ShowSourcesMode.  Set  this  option  to  True  if  you  wish  BiblioText  to  start  with  its 
viewer  in  Show  Sources  mode;  otherwise  set  it  to  False  (the  default).  Once 
BiblioText  is  running,  you  may  change  the  mode  at  any  time  with  a  panel  control. 
Section  5  (“How  BiblioText  Works”)  explains  the  effects  of  this  mode. 


- 13- 


BiblioText 


4.  How  to  Configure  BiblioText  for  Your  Data 


•  CommonWords.  The  program  invert,  when  extracting  potential  keywords  for  index¬ 
ing,  discards  certain  words  that  occur  frequently  and  carry  little  information.  These 
words  are  enumerated  in  a  file  whose  name  is  a  command  line  option  to  invert.  If  you 
build  an  index  with  any  file  other  then  invert's  default,  which  is 
/usr/new/lib/bmac/common,  you  should  specify  that  same  file  in  this  option.  The 
default  value  for  this  option  is  same  as  for  invert,  so  in  the  normal  case  you  need  not 
specify  it. 

BiblioText,  when  performing  a  Keyword  Lookup  command  (described  in  the  next  sec¬ 
tion),  preprocesses  its  argument  string  by  eliminating  punctuation  and  any  words  in  the 
file  named  by  this  option.  Thus  it  is  possible  (though  not  likely)  to  select  a  string  of  words 
for  lookup,  only  to  have  BiblioText  complain  that  no  “usable”  keywords  were  supplied. 


5.  How  BiblioText  Works 

This  section  explains  the  mechanisms  and  basic  concepts  behind  BiblioText.  This 
discussion  emphasizes  what  BiblioText  does,  and  complements  the  more  tutorial  presen¬ 
tation  in  Section  6  (“How  to  Use  BiblioText”). 

BiblioText  runs  on  a  bit-mapped  workstation  with  mouse.  Figure  1  shows  how 
BiblioText  appears,  as  a  window  containing  a  panel  and  a  scrollable  viewer.  The  panel 
at  the  top  contains  active  control  objects  in  its  first  line  and  displays  useful  information  in 
its  second  line.  The  rest  of  the  window  consists  of  the  viewer,  which  displays  the  current 
collection  of  refs,  and  where  the  main  menu  may  be  activated  (visible  in  Figure  1).  This 
section  discusses  each  of  these  in  more  detail. 

5.1.  The  Ref. 

BiblioText’ s  central  function  is  to  maintain  a  collection  of  refs,  for  viewing.  This 
section  begins  by  introducing  the  notion  of  a  single  ref. 

During  a  session  with  BiblioText,  a  ref.  is  an  internally  stored  copy  of  a  biblio¬ 
graphic  reference  in  raw  form  (see  Section  3.1,  “Bibliographic  Databases”).  It  should 
be  emphasized  that  the  ref.  is  just  a  copy  of  a  raw  ref.  from  your  bibliographic  database; 
BiblioText  cannot  modify  your  bibliographic  database. 

The  example  raw  ref.  in  Section  3,  repeated  here,  shows  how  the  ref.  consists  of 
lines  of  text.  Each  line  contains  a  field,  labeled  by  a  character  following  %  on  each  line. 
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Along  with  each  ref.  in  raw  form,  BiblioText  keeps  track  internally  of  the  following  asso¬ 
ciated  information: 

•  Ref.  Source:  This  is  the  name  of  the  file  from  which  the  raw  ref.  was  read  (not  the 
name  of  the  index  used  to  find  it). 

Since  BiblioText  does  not  retain  duplicate  refs,  in  the  current  collection,  and  since  there 
is  only  one  source  recorded  per  ref.,  it  is  in  general  not  possible  to  discover  multiple 
sources  for  a  single  ref. 

•  Cite  Source:  If  a  ref.  in  the  collection  was  located  via  imprecise  citation  in  a  docu¬ 
ment,  this  annotation  contains  (a)  the  name  of  the  document  file  containing  the  cita¬ 
tion,  and  (b)  the  citation  string  itself. 

•  Links:  BiblioText  treats  specially  any  fields  you  have  reserved  for  links,  keeping  an 
internal  map  of  link  values  for  use  during  possible  traversals.  In  the  example  ref.,  the 
%Y  field  is  a  cite  link,  and  the  %Z  field  is  a  file  link.  See  the  discussion  of  the 
Follow  <Link>  command  below  for  the  semantics  of  the  two  kinds  of  links. 

5.2.  The  Collection 

BiblioText  maintains  a  collection  of  refs,  that  changes  dynamically  in  response  to 
your  commands.  A  discussion  of  these  commands  will  follow,  but  for  now  three  impor¬ 
tant  aspects  of  the  collection  are  worth  mentioning: 

•  the  collection  is  an  ordered  list  of  refs.; 

•  the  collection  contains  no  duplicates;  and 

Refs,  are  compared  literally,  character  by  character,  for  equality.  This  prevents  the 
repeated  addition  of  the  same  ref.  by  successive  keyword  searches,  or  by  having  the  same 
ref.  source  file  indexed  multiply.  This  does  not  prevent  the  addition  of  the  same  ref. 
from  two  different  raw  ref.  files,  unless  they  happen  to  have  been  typed  identically. 

•  the  collection  is  always  numbered  sequentially. 

There  are  some  implementation  restrictions  in  BiblioText,  as  described  in  the  man  page. 

One  of  these  is  a  fixed  limit  on  size  of  the  collection  (along  with  limits  on  the  total  char¬ 
acter  count  in  a  single  ref.  and  on  the  character  count  in  a  single  field  of  a  ref.). 

5.3.  The  Viewer 

BiblioText’ s  viewer  is  a  scrollable  subwindow  that  constantly  displays  the  current 
collection,  formatted  for  rapid  browsing. 

The  viewer  is  an  instance  of  the  SunView  text  subwindow.  It  is  configured  to  be  read¬ 
only,  but  other  text  subwindow  functionality  is  available.  You  can  scroll  through  the 
display  using  the  standard  SunView  scrollbar.  You  can  change  the  size  of  the  viewer  by 
resizing  the  frame,  again  with  standard  SunView  commands  to  the  window  manager. 

You  can  use  the  textsw=>  submenu  of  the  main  menu  for  textual  searches  in  the  viewer. 

You  can  even  use  the  textsw->  submenu  to  split  the  viewer  into  multiple,  independently 
scrollable,  subwindows,  although  BiblioText  isn’t  designed  to  manage  split  viewers  par¬ 
ticularly  gracefully. 

The  viewer  presents  the  refs,  in  order,  separated  by  blank  lines  and  numbered 
according  to  position  in  the  current  collection.  The  viewer  formats  each  ref.  compactly, 
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according  to  simple  rules  that  approximate  standard  reference  formatting  in  bib.  Thus 
the  example  ref.  above  might  appear  in  the  viewer  as: 


1.  D.  C.  Engelbart  and  W.  K.  English, 

A  Research  Center  for  Augmenting  Human  Intellect,  Fall  Joint  Comp. 
Conf.  (1968),  395-410.  [%K]  [%X] 

<conceptual  framework  paper><notes> 


You  may  select  the  amount  of  information  presented  by  the  viewer  by  switching 
two  display  modes  on  and  off,  using  left  button  clicks  over  corresponding  buttons  in  the 
panel.  Switching  either  mode  causes  the  viewer  to  redisplay  the  collection  appropriately. 

Verbose  Display  Mode 

When  Verbose  Display  mode  is  off,  the  viewer  presents  refs,  in  a  terse  format 
designed  for  rapid  browsing  (as  shown  in  the  example  above).  BiblioText  uses  several 
techniques  for  the  terse  display.  Authors’  first  names  are  abbreviated,  appearing  as  “D. 
C.  Engelbart”  for  example,  instead  of  “Douglas  C.  Engelbart.”  Macro  (abbreviation) 
expansion  uses  short  names  instead  of  full  names,  such  as  “Proc.”  instead  of  "Proceed¬ 
ings.”  Finally,  certain  fields  are  elided,  as  explained  below. 

When  Verbose  Display  mode  is  on,  the  example  above  might  appear  instead  as: 

1 .  Douglas  C.  Engelbart  and  William  K.  English, 

A  Research  Center  for  Augmenting  Human  Intellect,  Fall  Joint  Computer 
Conference  (1968),  395-410. 

[%K]  hypertext  mouse  chord  keyboard 

[%X]  seminal  paper,  accompanied  by  astounding  demo 

<conceptual  framework  paper><notes> 


Show  Sources  Mode 

When  Show  Sources  mode  is  on,  the  viewer  annotates  each  formatted  ref.  with  file 
names  representing  the  ref.  source  and  the  cite  source  (if  any),  as  described  earlier.  The 
example  ref.  above,  (with  Verbose  Display  mode  turned  back  off)  might  then  appear  as: 


1 .  D.  C.  Engelbart  and  W.  K.  English, 

A  Research  Center  for  Augmenting  Human  Intellect,  Fall  Joint  Comp. 
Conf.  (1968),  395-410.  [%K]  [%X] 

<conceptual  framework  paper><notes> 

Ref. :  /users/mlvdv/bib/example.ref 
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Field  Formatting 


The  following  list  summarizes  how  the  viewer  presents  various  fields  from  each  raw 
ref.  Consult  documentation  for  the  various  bibliographic  databases  for  the  standard  field 
definitions 


Standard  fields:  %A,  %B,  %C,  %D,  %E,  %G,  %l,  %J,  %N,  %0,  %P,  %R,  %T,  %V. 
The  viewer  formats  various  subsets  of  these  fields  according  to  standard  bibliographic 
convention,  depending  on  the  type  of  document  referenced.  A  single  ref.  may  contain 
multiple  instances  of  %A  and  %E  fields.  If  any  fields  in  this  list  (other  than  %A  or 
%E)  appear  more  than  once  in  a  ref.,  the  viewer  presents  only  the  last  of  each. 


Link  fields:  Any  fields  defined  to  be  links  in  your  data  will  be  presented  in  a  special 
way,  independent  of  the  two  viewing  modes.  The  viewer  presents  the  name  of  each 
link,  surrounded  by  the  bracketing  characters  “<”  and  the  Follow  <Link>  com¬ 
mand  is  available  to  traverse  these  links,  as  discussed  below. 


•  All  other  fields:  The  viewer  formats  all  other  fields  in  a  standard  way.  When  Verbose 
Display  mode  is  off,  only  the  field  label  appears  (in  the  form  “[%K]”)  to  announce  the 
presence  of  the  field.  When  Verbose  Display  mode  is  on,  each  label  is  followed  by 
the  contents  of  the  field  (as  in  “[%K]  hypertext  mouse  chord  keyboard”).  A  single  ref. 
may  contain  multiple  instances  of  any  of  these  other  fields;  all  will  appear  in  the 
viewer. 


The  Main  Menu 

The  remainder  of  this  section  describes  various  BiblioText  commands  for  operating 
on  the  contents  of  the  current  collection.  Most  of  these  commands  are  available  as  selec¬ 
tions  from  BiblioText’s  main  menu,  visible  in  Figure  1.  To  invoke  the  main  menu,  press 
the  right  mouse  button  while  the  cursor  is  over  the  viewer. 

5.4.  Selection 

Many  of  BiblioText’s  commands  require  arguments  that  you  may  supply  by  prior 
mouse  selection.  Some  commands  require  string  arguments,  some  commands  require 
that  you  select  one  more  more  refs,  from  the  current  collection,  and  one  command 
requires  that  you  select  a  specific  link  from  the  display. 

String  Arguments 

BiblioText  commands  that  require  string  arguments  will  always  attempt  to  use  the 
SunView  primary  selection.  To  create  a  primary  selection,  simply  point  at  any  characters 
in  any  window  on  your  screen  and  select  a  string  of  characters  using  the  standard  Sun- 
View  conventions.  When  one  of  these  commands  is  unable  to  make  use  of  the  SunView 
primary  selection,  BiblioText  will  present  you  with  a  popup  prompter  in  which  to  type 
the  required  string  argument. 

You  may  select  text  for  string  arguments  anywhere  on  your  workstation  screen,  not  just 
in  the  BiblioText  window.  This  is  useful  for  picking  up  keywords  and  file  names  from 
your  editor  window,  for  example. 
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Ref.  Selection 

BiblioText  commands  that  require  a  selection  of  refs,  work  slightly  less  obviously. 
To  select  a  single  ref.,  use  the  mouse  to  select  any  text  in  BiblioText’s  viewer  that 
corresponds  to  that  ref.  Only  the  characters  you  select  will  be  highlighted,  as  with  any 
primary  text  selection,  but  BiblioText  commands  will  identify  the  selected  ref.  from  as 
little  as  a  single  character  selection.  To  select  more  than  one  ref.,  simply  select  a  string 
of  characters  that  begins  somewhere  in  the  first  ref.  you  want  and  that  ends  somewhere 
in  the  last  ref.  you  want.  When  one  of  these  commands  is  unable  to  interpret  the  Sun- 
View  primary  selection  as  a  selection  of  refs.,  BiblioText  will  complain  and  ask  you  to 
try  again. 

It  is  possible  to  select  the  blank  line  between  two  refs,  in  the  viewer.  BiblioText  treats 
this  selection  as  belonging  to  the  previous  ref. 

Link  Selection 

The  Follow  <Link>  command,  discussed  in  more  detail  below,  requires  that  you 
select  a  specific  link  from  the  display  in  the  viewer.  BiblioText  derives  the  selected  link 
from  the  primary  text  selection  in  the  viewer  by  considering  only  the  first  character 
selected.  Thus,  a  single  left  click  anywhere  over  the  name  of  a  link  (including  the  brack¬ 
eting  characters)  suffices  to  select  a  link. 

5.5.  Adding  Refs. 

BiblioText  begins  each  session  with  an  empty  collection.  You  may  add  refs,  to  the 
collection  in  several  ways:  by  keyword  search  (in  the  manner  of  lookup),  by  loading  raw 
refs,  directly,  or  by  extracting  citations  from  a  document  (in  the  manner  of  bib).  In  every 
case  BiblioText  will  do  the  following  with  newly  added  refs.: 

•  discard  any  new  ref.  that  is  already  in  the  collection,  preventing  duplicates; 

•  append  remaining  new  refs,  to  the  collection,  in  the  order  in  which  they  were  found; 
and 

•  scroll  the  viewer  automatically  so  that  the  first  of  the  newly  added  refs,  appears  at  the 
top  of  the  viewer. 

Keyword  Lookup 

You  may  select  Keyword  Lookup  from  the  main  menu  to  invoke  an  indexed  search. 
This  search  works  much  like  the  program  lookup,  and  uses  the  keywords  you  specify  as  a 
string  argument.  If  there  are  no  usable  keywords  selected  (anywhere  on  the  screen),  you 
will  be  prompted  for  them.  The  search  will  proceed  in  order  through  every  index  that  is 
currently  active,  and  every  ref.  that  matches  the  keywords  will  be  added  to  the  collection. 

BiblioText,  like  lookup,  extracts  matches  from  each  index  by  looping  over  the  keywords 
you  supply;  both  programs  have  an  implementation  restriction  that  limits  how  many  refs, 
the  first  keyword  may  match,  per  index.  Thus,  you  should  avoid  using  words  like  “com¬ 
puter”  as  the  first  keyword  (they  won’t  cause  problems  if  they  aren’t  used  as  the  first 
keyword). 


-  19- 


BiblioText 


5.  How  BiblioText  Works 


To  control  which  indexes  are  currently  active,  left  click  over  the  panel  button 
Set  Indexes.  BiblioText  will  pop  up  an  auxiliary  window  that  lists  the  indexes  currently 
available  to  you,  along  with  a  control  button  for  switching  the  status  of  each  between 
active  and  inactive.  Use  left  mouse  clicks  to  select  the  indexes  you  want  to  use,  and  then 
make  the  auxiliary  window  disappear  by  clicking  the  Done  button.  Section  4 
(“Configuring  BiblioText  for  Your  Data”)  explains  how  to  make  indexes  available. 

Add  Raw  Refs. 

You  may  add  a  file  of  refs,  in  raw  format  directly  to  the  collection  by  selecting 
Load  from  File  from  the  main  menu.  This  command  uses  the  string  argument  you  supply 
as  a  file  name;  if  there  is  no  usable  file  name  selected  (anywhere  on  the  screen) 
BiblioText  prompts  you  for  one.  In  either  case,  if  you  specify  a  file  name  that  does  not 
begin  with  BiblioText  interprets  it  relative  to  the  current  working  directory  (always 
visible  in  the  banner  at  the  top  of  BiblioText’ s  window). 

Add  From  a  Document  Containing  Citations 

You  may  add  refs,  by  extracting  all  the  refs,  cited  in  a  document  file;  this  amounts 
to  previewing  the  reference  list  of  the  document.  Select  Load  from  File  from  the  main 
menu,  the  same  command  used  for  reading  raw  refs.;  BiblioText  determines  by  inspec¬ 
tion  which  kind  of  file  you  have  specified. 

BiblioText’ s  Load  from  File  command,  when  given  a  document  file,  mimics  the 
operation  (and  semantics)  of  bib .  For  each  citation  that  it  encounters  in  the  file,  it 
searches  the  active  indexes  in  order,  but  only  until  it  matches  something.  It  is  a  bib  error 
to  match  multiple  refs,  in  a  single  index;  likewise,  it  is  a  bib  error  for  a  citation  to  match 
nothing  at  all.  The  Load  from  File  command  keeps  track  of  these  errors  and,  when 
finished,  announces  them  in  an  auxiliary  window  that  pops  up  for  just  this  purpose. 

The  command  Load  from  File  mimics  the  semantics  of  bib,  while  the  command 
Keyword  Lookup  mimics  the  semantics  of  lookup.  The  subtle  distinction  between  them, 
as  suggested  above,  can  create  some  confusion  if  you  look  too  closely  and  if  you  aren’t 
especially  familiar  with  bib. 

Because  of  a  SunView  implementation  restriction  on  the  number  of  windows  that  a  sin¬ 
gle  process  may  create,  BiblioText  recycles  a  single  auxiliary  window.  Thus,  you  can 
lose  the  error  list  produced  by  the  load  command  if  you  run  any  other  BiblioText  com¬ 
mands  that  pops  up  an  auxiliary  display,  such  as  View  Raw  Refs. 

5.6.  Traversing  Links 

When  a  ref.  in  BiblioText’s  current  collection  contains  links,  the  names  of  the  links 
appear  in  the  viewer,  delimited  by  “<”  and  “>”  as  shown  for  the  example  ref.: 
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1 .  D.  C.  Engelbart  and  W.  K.  English, 

A  Research  Center  for  Augmenting  Human  Intellect,  Fall  Joint  Comp. 

Conf.  (1968),  395-410.  [%K]  [%X] 

<conceptual  framework  paper><notes> 

You  may  examine  the  object  pointed  to  by  a  link  by  first  selecting  the  link,  and  then 
selecting  Follow  <Link>  from  the  main  menu.  As  discussed  in  Section  5.4  (“Selection”), 
you  can  select  a  link  by  simply  left  clicking  over  any  character  in  the  name  that  appears 
in  the  viewer  (including  either  bracketing  character).  BiblioText  attempts  to  traverse  the 
selected  link,  either  to  another  ref.  or  to  a  file,  depending  on  the  type  of  the  link  you  have 
selected. 

Traversing  Cite  Links 

If  you  have  selected  a  cite  link  for  traversal  (like  the  link  named  “cconceptual 
framework  paper>,”  in  the  example  ref.),  BiblioText  attempts  to  locate  the  cited  ref.  in 
the  same  way  that  bib  does.  BiblioText  searches  the  active  indexes  in  order,  but  only 
until  it  matches  something.  Although  it  is  a  bib  error  for  a  citation  to  match  multiple 
refs,  in  a  single  index,  BiblioText  is  more  tolerant  and  just  prints  a  message  to  that  effect. 
In  any  case,  BiblioText  adds  the  cited  ref.  (or  refs,  if  the  citation  happened  to  match  more 
than  one)  to  the  collection,  if  it  isn’t  already  there,  and  then  positions  the  viewer  so  that 
the  cited  ref.  appears  at  the  top  of  the  viewer. 

If  the  value  of  a  cite  link  field  matches  more  than  one  ref,  BiblioText  positions  the  viewer 
at  the  first  one  found,  whether  or  not  it  was  already  in  the  collection,  and  whether  or  not 
any  of  the  others  were. 

Traversing  File  Links 

When  you  select  a  file  link  for  traversal  (like  the  link  named  “<notes>,”  in  the 
example  ref.),  BiblioText  attempts  to  display  the  named  file  for  viewing  (and  editing)  in 
an  auxiliary  window.  If  the  file  name  in  the  link  field  does  not  begin  with  “/”,  BiblioText 
interprets  the  name  relative  to  the  directory  from  which  the  raw  ref.  was  originally  read. 

The  auxiliary  window  in  which  separate  notes  appear  is  a  standard  SunView  text  subwin¬ 
dow,  which  is  also  an  instance  of  the  SunView  editor.  You  may  edit  these  document  files 
in  the  auxiliary  window,  since  this  does  not  affect  the  validity  of  your  bibliographic 
indexes. 

Nobody  in  our  environment  knows  how  to  use  the  SunView  editor. 

Because  of  a  SunView  implementation  restriction  on  the  number  of  windows  that  a  sin¬ 
gle  process  may  create,  BiblioText  recycles  one  window  for  most  auxiliary  uses.  An 
unpleasant  result  of  this  limitation  is  that  you  can  only  browse  one  external  document  file 
at  a  time. 
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5.7.  Creating  Citations 

Once  you  have  used  BiblioText  to  locate  a  particular  ref.,  you  may  want  to  add  to 
some  document  file  an  imprecise  citation,  as  defined  by  bib,  that  identifies  the  ref.  You 
may  request  the  creation  of  such  a  citation  by  selecting  Make  Citation  from  the  main 
menu.  This  command  attempts  to  create  a  unique  imprecise  citation  for  the  first  of  the 
currently  selected  refs;  it  does  so  with  heuristics  and  an  inefficient  repeated  search  of  the 
indexes.  When  the  heuristics  fail,  BiblioText  will  notify  you. 

When  this  command  succeeds,  the  citation  is  guaranteed  to  identify  uniquely  the  selected 
ref.,  but  only  relative  to  the  set  of  indexes  currently  active  when  the  command  is  invoked. 

An  evolving  database  can  render  previously  unique  citations  erroneous;  the 
Load  from  File  command,  described  earlier,  is  a  convenient  way  to  verify  the  integrity  of 
citations  in  your  document  files. 

When  the  Make  Citation  command  succeeds,  it  writes  the  result,  complete  with  sur¬ 
rounding  “[.”  and  “.]"  delimiters,  into  a  text  field  on  the  second  line  of  the  panel.  From 
there  you  can  either  copy  it  into  your  document  manually,  or  you  use  the  SunView  selec¬ 
tion  service  to  copy  it  automatically. 

Because  of  a  SunView  quirk,  you  may  select  the  newly  created  citation  only  in  its 
entirety;  this  happens  in  response  to  a  single  left  click.  While  this  is  completely  con¬ 
sistent  with  the  intended  use  here,  it  can  be  a  bit  disconcerting. 

5.8.  Deleting  Refs. 

When  you  want  to  discard  refs,  from  the  current  collection,  select  a  command  from 
the  Delete=>  submenu  of  the  main  menu.  These  commands  affect  only  the  contents  of 
BiblioText’ s  current  collection  and  can  have  no  effect  on  your  bibliographic  databases. 

Delete  Selected  Refs. 

The  Delete  Selected  Refs,  command  requires  that  you  have  selected  one  or  more 
of  the  refs,  in  the  collection,  as  discussed  earler  under  Selection.  It  removes  the  selected 
refs,  and  renumbers  the  collection. 

Because  of  the  peculiarity  in  ref.  selection  mentioned  earlier,  BiblioText  treats  the  space 
between  two  refs,  as  part  of  the  preceding  ref.  Thus,  if  you  attempt  to  select  all  the  text 
in  a  single  ref.  and  you  accidentally  include  the  preceding  blank  line  with  your  selection, 
you  will  have  selected  two  refs,  instead  of  one. 

Delete  Collection 

The  Delete  Collection  command  deletes  the  entire  contents  of  the  collection,  and 
requires  no  selection.  As  a  precaution,  BiblioText  asks  for  a  confirming  mouse  click  and 
allows  you  to  cancel  the  command. 

5.9.  Sorting  the  Collection 

To  sort  the  current  collection,  use  a  right  mouse  click  over  the  Sort:  item  on  the 
panel.  Choose  from  the  menu  of  possible  orderings  (for  example  Author-Date),  and 
BiblioText  will  sort  the  collection. 
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After  sorting,  the  order  you  chose  appears  opposite  Sort:  in  the  panel  and  remains 
until  something  happens  to  change  the  ordering.  When  you  add  new  refs,  to  the  collec¬ 
tion,  which  are  always  appended,  the  ordering  becomes  indeterminate  and  Unsorted 
again  appears. 

Selecting  Unsorted  from  the  sort  menu  does  nothing  to  the  collection. 

There  is  a  slightly  non-obvious  SunView  “accelerator”  associated  with  the  Sort:  item  on 
the  panel.  A  left  mouse  click  over  the  item  is  taken  as  a  command  that  selects  the  next 
ordering  from  the  list.  Since  the  current  sort  order  is  usually  Unsorted,  and  the  next  ord¬ 
ering  on  the  menu  is  Author-Date,  a  simple  left  click  over  this  item  usually  has  the  effect 
of  requesting  a  sort  by  author  and  date. 

Sorting  is  one  way  to  help  you  find  particular  refs,  in  the  collection,  especially  when  the 
collection  is  large.  In  addition,  textual  search  is  available  in  the  viewer,  via  the  standard 
SunView  Find  command  in  the  textsw=>  submenu  of  the  main  menu. 


5.10.  Saving  the  Collection 

You  may  save  the  current  collection  in  your  choice  of  format  by  selecting  a  com¬ 
mand  from  the  Save  to  File=>  submenu  of  the  main  menu.  Each  of  these  three  com¬ 
mands  uses  the  string  argument  you  supply  as  a  file  name;  if  there  is  no  usable  file  name 
selected  (anywhere  on  the  screen)  BiblioText  prompts  you  for  one.  In  either  case,  if  you 
specify  a  file  name  that  does  not  begin  with  BiblioText  interprets  it  relative  to  the 
current  working  directory  (always  visible  in  the  banner  at  the  top  of  BiblioText’s  win¬ 
dow). 

Save  Formatted  Refs. 

The  Save  Formatted  Refs,  command  writes  the  collection  into  a  text  file  that 
closely  approximates  the  formatted  display  you  see  in  the  viewer.  This  is  convenient  for 
a  quick  hard  copy,  but  has  the  disadvantage  that  none  of  the  information  it  contains  is 
recoverable  by  BiblioText. 

Save  Raw  Refs. 

The  Save  Raw  Refs,  command  writes  the  collection  into  a  text  file  of  raw  refs. 
This  is  useful  for  manipulating  your  bibliographic  database  in  some  cases.  It  may  also  be 
necessary  for  a  hard  copy  when  the  formatted  version  is  insufficient  for  some  reason. 
The  file  may  be  loaded  back  into  BiblioText,  but  since  the  original  source  is  not 
recorded,  refs,  will  then  look  like  duplicates  from  different  sources. 

Save  Citations 

The  Save  Citations  command  writes  a  list  of  imprecise  citations  (using  the  mechan¬ 
ism  described  above)  to  a  text  file.  Unlike  saving  raw  refs.,  which  copies  the  database 
entry,  this  command  stores  what  amounts  to  a  pointer  to  the  original  database  entry.  This 
file  may  be  loaded  like  any  other  document  file  containing  citations,  and  the  original 
referents  will  be  retrieved  (assuming  the  same  set  of  active  indexes,  and  that  the  indexes 
have  not  changed  enough  to  render  ambiguous  any  of  the  citations). 
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5.11.  More  Information 

While  browsing  with  BiblioText,  you  may  request  several  kinds  of  additional  infor¬ 
mation  with  commands  from  the  More  lnfo=>  submenu  of  the  main  menu.  In  each  case, 
BiblioText  pops  up  an  auxiliary  window  containing  the  requested  information;  the  auxili¬ 
ary  window  persists  until  you  left  click  the  Done  button. 

View  Raw  Refs. 

The  View  Raw  Refs  command  displays  one  or  more  refs.,  selected  from  the  collec¬ 
tion,  in  their  original  raw  form. 

View  Definitions 

BiblioText  expands  raw  refs,  using  a  macro  definition  (or  abbreviation)  facility. 
You  may  examine  the  definition  files  BiblioText  is  currently  using  by  running  the  View 
Definitions  command.  An  auxiliary  frame  will  appear  that  consists  of  a  text  subwindow, 
in  which  one  file  may  be  viewed,  and  a  small  panel,  from  which  you  may  select  the 
definition  file  for  viewing.  Section  4  (“Configuring  BiblioText  for  Your  Data”)  explains 
how  to  make  definition  files  available. 


6.  How  to  Use  BiblioText 

Earlier  sections  described  aspects  of  BiblioText’s  operation  that  you  need  to  under¬ 
stand  to  make  it  work:  data  (Section  3),  configuration  (Section  4),  and  operation  (Section 
5).  This  section  draws  on  all  three  aspects,  but  from  a  different  perspective:  how  to  use 
BiblioText  to  get  your  work  done. 

As  with  any  tool,  it  is  impossible  to  enumerate  completely  how  BiblioText  might  be 
used,  but  this  section  should  suggest  some  ways  to  get  started.  It  is  organized  around 
several  general  (and  overlapping)  tasks  for  which  you  might  find  BiblioText  useful.  The 
presentation  is  ordered  so  that  the  tasks  appearing  first  require  the  least  amount  of  special 
preparation.  As  BiblioText  becomes  more  and  more  part  of  your  work,  you  may  find  that 
the  overhead  required  for  the  later  tasks  in  this  list  becomes  worthwhile. 

6.1.  Writing  A  Paper 

For  this  section,  assume  that  you  are  going  to  write  a  paper  in  which  bibliographic 
references  play  a  role.  The  discussion  presumes  that  you  use  bib  as  a  bibliographic 
preprocessor  to  the  troff  document  typesetter,  but  you  could  just  as  well  be  using  tib  and 
TeX. 

Assume  further  that  you  have  a  simple  bibliographic  database.  If  you  are  new  to 
bib,  you  might  have  created  the  database  just  for  the  paper  at  hand,  adding  the  references 
you  expect  to  cite.  If  you  have  used  bib  before,  your  database  may  contain  at  least  all  the 
documents  cited  in  other  papers  you’ve  written.  Finally,  assume  that  you  have 
BiblioText  running  on  your  workstation,  alongside  a  text  editor  in  which  you  are  writing 
the  paper. 
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At  this  basic  level,  BiblioText  can  help  with  three  tasks  involved  with  writing  a 
paper. 

•  Locate  the  bibliographic  data  for  a  document  you  have  decided  to  cite. 

•  Create  an  imprecise  citation  for  the  ref.,  and  insert  it  into  your  document 

•  Preview  your  document’s  reference  list,  and  ensure  that  imprecise  citations  are  valid. 


Locate  a  Ref. 

You  often  don’t  know  exactly  which  documents  you  will  cite  until  you  are  writing 
the  paper.  BiblioText  helps  you  to  retrieve  relevant  bibliographic  data  when  you  need 
them,  without  having  to  leave  your  workstation  to  rummage  through  books,  journals,  and 
notes. 

If  you  have  a  very  small  bibliographic  database,  created  for  just  one  paper,  then  you 
can  conveniently  browse  through  its  entire  contents.  Use  the  Load  from  File  command  to 
add  the  raw  ref.  file  to  the  current  collection,  where  it  will  be  formatted  for  easy  perusal. 
Scroll  through  the  collection  until  you  find  the  ref.  you  want;  sorting  the  collection  some¬ 
times  helps. 

If  you  have  a  large  bibliographic  database,  on  the  other  hand,  you  can  locate  a  par¬ 
ticular  ref.  quickly  with  the  Keyword  Lookup  command.  Just  enter  one  or  two  author 
names  for  keywords,  or  perhaps  one  important  word  from  the  title.  To  save  time,  select 
the  authors’  names  direcdy  from  your  editor’s  window,  if  the  names  happen  to  appear  in 
the  text  you  are  writing.  If  the  keywords  match  no  refs.,  then  try  again  with  new  key¬ 
words;  you  may  have  misspelled  an  author’s  name.  Don’t  worry  about  keyword  searches 
matching  more  than  one  ref.;  it  is  usually  convenient  to  scroll  through  the  matching  refs, 
until  you  find  the  one  you  have  in  mind. 

Create  and  Insert  a  Citation 

Once  you  have  located  the  ref.  you  have  in  mind,  you  will  want  to  insert  an  impre¬ 
cise  citation  at  the  appropriate  point  in  your  document.  This  traditionally  required  guess¬ 
work,  since  you  must  combine  keywords  that  identify  exactly  one  ref.  in  your  database. 
Using  bib  it  is  difficult  to  discover  errors  until  you  attempt  to  print  your  document. 

With  BiblioText,  use  the  Make  Citation  command,  after  first  selecting  the  ref.  you 
want  to  cite.  BiblioText  will  attempt  to  create  a  citation,  using  heuristics,  and  display  the 
entire  citation  string,  complete  with  and  delimiters,  on  the  control  panel.  Since 
the  procedure  is  heuristic,  it  can  fail  when  your  database  contains  nearly  identical  refs. 
When  the  procedure  succeeds,  the  resulting  citation  is  guaranteed  correct  for  the  indexes 
you  have  active  in  BiblioText  at  the  time. 

When  the  citation  appears,  you  can  use  SunView’s  selection  service  to  copy  the 
string  out  of  BiblioText’ s  panel,  complete  with  delimiters,  into  the  text  of  your  docu¬ 
ment. 

Preview  the  Reference  List  and  Check  for  Errors 

If  you  are  examining  a  document  that  already  contains  citations,  you  can  preview 
the  document’s  reference  list  by  extracting  them  and  adding  them  to  BiblioText’s 
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collection.  Use  the  Load  from  File  command  on  the  document  file.  If  your  editor  displays 
the  name  of  the  file  somewhere,  you  can  save  time  by  selecting  the  file  name  from  the 
editor’s  window  before  invoking  the  command. 

When  BiblioText  loads  references  via  citations  from  a  document  file,  it  mimics  the 
semantics  of  bib  and  attempts  to  find  a  unique  match  for  each  citation.  It  is  a  bib  error 
for  a  citation  to  match  other  than  exactly  one  ref.  in  an  index;  BiblioText  collects  notes 
on  any  such  errors  and  displays  them  in  an  auxiliary  window  when  the  load  command 
finishes. 

Running  this  command  is  a  useful  precaution  when  you  change  your  bibliographic 
database;  it  is  an  inherent  weakness  of  bib's  imprecise  citation  mechanisms  that  database 
changes  can  invalidate  previously  correct  citations. 

6.2.  Keeping  Notes 

The  previous  section  assumed  only  that  you  maintain  a  simple  bibliographic  data¬ 
base.  If,  in  addition,  you  take  notes  on  some  of  your  readings,  and  if  you  chose  to  keep 
them  online,  this  section  suggests  how  you  might  organize  your  notes  to  take  further 
advantage  of  BiblioText. 

Nothing  in  this  discussion  insists  that  these  notes  (or,  more  accurately,  online  docu¬ 
ments)  be  of  your  own  creation.  They  can  also  be  comments  sent  by  electronic  mail 
from  colleagues.  They  can  be  reviews  and  recommendations  downloaded  from  electronic 
bulletin  boards.  They  might  even  be  abstracts  of  the  documents  involved,  when  an  online 
source  is  available. 

At  this  level,  where  you  maintain  a  bibliographic  database  with  associated  online 
documents,  BiblioText  can  help  with  two  tasks. 

•  Given  a  particular  ref.  in  your  bibliographic  database,  quickly  locate  various  related 
online  documents  for  viewing. 

•  Given  an  online  document  containing  notes  about  a  ref.,  quickly  locate  the  ref.  itself 
from  the  bibliographic  database  (and,  by  extension,  any  other  notes  related  to  the  ref.). 

Links  from  Refs,  to  Documents 

When  you  create  or  receive  an  online  document  that  concerns  a  document  refer¬ 
enced  in  your  bibliographic  database,  you  can  record  the  relationship  with  a  file  link.  In 
the  simplest  case,  suppose  that  you  are  reading  a  paper  that  will  be  important  for  your 
work.  Add  a  ref.  describing  the  paper  to  your  bibliographic  database,  if  it  isn’t  already 
there;  include  in  that  ref.  a  file  link  like  the  one  appearing  in  the  examples  of  Section  3: 


%Z  notes  note/Engelbart68.ms 

The  word  “notes”  is  the  name  of  the  link.  The  rest  of  the  link  field  describes  the  file 
where  you  will  write  your  notes. 

During  a  browsing  session  with  BiblioText,  you  can  select  the  name  of  the  link 
(which  appears  in  the  viewer  as  “<notes>”  and  use  the  Follow  <Link>  command  to 
display  the  linked  file  in  a  separate  window  for  further  browsing.  If,  during  your  reading. 
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you  had  the  foresight  to  record  important  quotes  or  other  items  from  the  paper,  you  can 
use  SunView’s  selection  service  to  copy  excerpts  of  your  notes  out  of  BiblioText, 
directly  into  your  document. 

The  name  of  a  link  can  be  any  string  that  will  remind  you  of  the  relationship 
between  the  ref.  and  the  document,  for  example  “Joe’s  critique,”  “short  excerpt,”  or 
“abstract.”  A  single  ref.  can  contain  any  number  of  file  links,  although  it  is  a  good  idea  to 
name  them  all  differently  to  avoid  confusion.  Conversely,  a  single  online  document  may 
be  relevant  to  more  than  one  ref.  in  your  bibliographic  database;  record  this  many-to-one 
relationship  by  adding  an  identical  file  link  to  each  ref. 

Links  from  Documents  to  Refs. 

When  a  file  link  points  from  a  ref.  to  an  online  document,  it  can  also  be  helpful  to 
record  the  reverse  relationship,  pointing  from  the  file  back  to  a  ref.  A  mechanism  already 
exists  for  doing  this,  the  imprecise  citation.  When  you  write  an  ordinary  paper  with  cita¬ 
tions,  you  are  doing  just  this,  adding  links  at  various  places  in  your  document,  pointing  to 
refs,  in  your  bibliographic  database. 

To  follow  this  type  of  link  during  browsing,  simply  select  the  text  of  the  citation 
(anywhere  on  the  workstation  screen)  and  use  BiblioText’ s  Keyword  Lookup  command 
to  locate  the  ref.  from  your  database.  Don’t  worry  about  selecting  the  delimiters  in  the 
document,  "[.”  and  BiblioText  discards  punctuation  before  producing  keywords  from 
your  selection. 

In  a  document  file  containing  notes  describing  one  or  more  refs.,  you  might  want  to 
formalize  the  citations  (links)  a  bit  by  putting  them  in  a  special  place  at  the  beginning. 
Write  comments  around  the  links  for  extra  identification,  especially  if  more  than  one 
appear  in  a  single  file  of  notes. 

For  printed  copies  of  your  notes,  use  the  bib  preprocessor  to  replace  each  citation 
(link)  with  a  full  description  of  the  ref.  For  best  results,  try  hiding  the  citation  in  a  troff 
comment  (as  explained  in  Section  3.2).  Then  use  the  “-f”  option  to  bib;  this  removes  the 
formatted  citation  and  inserts  the  reference  data  at  the  point  of  citation.  As  a  final 
refinement,  develop  your  own  bib  reference  formatting  style  for  this  application;  for 
example,  you  might  want  to  format  fields  like  %W  or  %X,  which  bib  otherwise  ignores. 

6.3.  Keeping  Subject  and  Reading  Lists 

This  section  suggests  how  you  might  organize  your  data  to  help  maintain  subject 
lists  of  documents  or  lists  of  documents  that  you  might  want  to  read  eventually.  In  an 
information-based  working  environment,  there  are  typically  many  more  documents  like 
this  than  there  is  time  for  reading,  but  it  can  become  important  to  locate  something  you 
noticed  earlier. 

The  traditional  manual  technique  is  to  accumulate  documents  in  piles,  organized  by 
subject  or  project.  This  technique  can  be  effective[Mal82],  but  it  doesn’t  scale  well. 
Aside  from  the  obvious  environmental  hazards,  complications  arise  when  the  piles 
become  too  large  or  too  numerous.  For  example,  it  becomes  difficult  to  retrieve  particu¬ 
lar  documents,  when  the  need  for  them  arises  in  a  new  context.  Sometimes  a  single 
document  might  belong  in  more  than  one  pile,  and  sometimes  you  want  to  add  to  a  pile  a 
document  that  you  don’t  own,  or  that  you  have  lent  to  a  colleague. 
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With  some  additional  investment  in  your  data,  you  can  use  BiblioText  to  replace 
your  physical  piles  of  documents.  Assume,  instead,  that  you  have  some  other  way  of 
organizing  your  documents  so  that,  when  you  locate  a  ref.  in  your  bibliographic  database, 
you  can  physically  locate  the  corresponding  document  without  too  much  trouble  (see  the 
following  section  for  some  hints  on  how  to  use  BiblioText  for  this,  too). 

Given  the  flexibility  of  the  bibliographic  database  and  BiblioText,  you  can  choose 
from  three  different  techniques  for  managing  your  subject  and  reading  lists;  the  rest  of 
this  section  will  discuss  each  in  turn.  Whichever  technique  you  adopt,  you  will  probably 
want  to  accomplish  the  following  at  various  times: 

•  Start  a  new  subject  list  from  scratch,  perhaps  drawing  on  information  already  stored  in 
your  bibliographic  database. 

•  Add  to  a  list  a  ref.  that  you  have  just  noticed  (whether  or  not  you  have  read  it  yet). 

•  Make  a  note  about  why  a  particular  ref.  should  be  on  a  particular  list. 

•  Browse  through  a  list. 

•  Print  a  copy  of  a  list,  along  with  various  notes  and  annotations. 

Subject-based  Raw  Ref.  Files 

The  simplest  technique,  and  the  one  that  scales  least  well,  is  to  create  files  of  raw 
ref.  data  that  correspond  to  physical  piles.  Name  each  file  according  to  the  subject  or 
project  for  which  it  was  collected,  such  as  hypertext.ref,  and  index  the  .ref  files  together. 

To  start  a  new  subject  list,  or  add  to  an  existing  one,  use  your  editor  to  add  raw  refs, 
to  a  new  file  or  to  an  existing  one  (and  then,  as  always,  rebuild  your  index).  Use  inline 
comments  (in  the  %X  field)  to  record  the  reason  for  a  particular  ref.  appearing  in  a  partic¬ 
ular  list. 

To  browse  a  subject  list  in  BiblioText,  use  the  Load  from  File  command  to  add  the 
entire  raw  ref.  file  to  the  collection.  There  are  several  ways  to  print  a  copy.  For  example, 
use  the  preprocessor  listrefs  (or  roffbib)  for  troff,  or  the  preprocessor  tiblist  for  TeX.  Or, 
for  a  simpler  version,  load  the  file  into  BiblioText  and  write  out  the  collection  in  the  sim¬ 
ple  form  that  approximates  the  display  in  BiblioText’ s  viewer. 

The  drawbacks  to  this  approach  are  structural.  As  your  database  grows,  fluid 
notions  like  “subject”  and  “project”  do  not  partition  your  data  neatly,  nor  are  the  dis¬ 
tinctions  likely  to  be  stable.  Some  refs,  may  belong  in  more  than  one  list,  while  others 
move  frequently.  Finally,  you  cannot  conveniently  include  refs,  from  a  colleague’s  data¬ 
base  without  making  a  personal  copy. 

Special  Keywords  for  Indexing 

A  somewhat  better  approach  separates  the  structure  of  the  database  from  notions  of 
“subject”  and  “project.”  Instead,  create  a  unique  keyword  for  each  list  you  wish  to 
maintain  (for  example  “htextl  ”)  and  add  this  keyword  to  each  ref.  you  want  to  have  in 
the  list. 

To  start  a  new  subject  list,  or  add  to  an  existing  one,  use  your  editor  to  add  the  line: 
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%K  htextl 

to  each  ref.  you  want  on  the  new  list  (and  then,  as  always,  rebuild  your  index). 

To  browse  a  particular  subject  or  project  list,  use  the  Keyword  Lookup  command  in 
BiblioText  to  find  all  refs,  with  the  desired  keyword.  To  print  list,  use  one  of 
BiblioText’s  three  Save  to  File  commands.  If  you  use  the  Save  Formatted  Refs,  com¬ 
mand,  you  will  get  a  file  you  can  print  directly,  approximating  the  display  in  the  viewer. 
If  you  use  the  Save  Raw  Refs,  command,  you  can  typeset  the  resulting  raw  ref.  file  by 
using  the  listrefs  (or  roffbib)  preprocessor  for  troff,  or  the  tiblist  preprocessor  for  TeX.  If 
you  use  the  Save  Citations  command,  you  can  typeset  the  resulting  file  of  citations  by 
using  bib  with  the  -f  option  as  the  preprocessor  to  troff. 

One  drawback  to  this  approach  is  the  danger  of  keyword  collision.  Since  most 
indexes  are  built  with  keywords  truncated  to  6  characters,  careless  selection  can  result  in 
unanticipated  refs,  falling  into  a  list  A  second  drawback  is  that  you  still  must  modify  the 
database  to  add  a  ref.  to  a  list.  Third,  if  you  want  to  add  refs,  from  a  colleague’s  data¬ 
base,  you  will  still  have  to  make  your  own  copy.  The  final  drawback  is  the  lack  of  any 
natural  place  for  comments.  A  ref.  may  be  included  in  two  lists  by  adding  two  key¬ 
words,  but  you  can  only  annotate  the  ref.  itself,  not  the  reasons  for  membership  in  a  par¬ 
ticular  list. 

Reading  Lists  with  Citations 

The  most  general  approach,  and  the  one  which  scales  best,  is  to  maintain  subject 
lists  as  separate  document  files,  each  containing  a  list  of  imprecise  citations.  Name  each 
file  according  to  the  subject  or  project  for  which  it  was  collected,  such  as  hypertext.bib. 

To  create  a  new  list,  browse  your  bibliographic  databases  with  BiblioText,  using  the 
commands  Keyword  Lookup,  Sort,  and  Delete  Selected  Refs,  until  the  current  collection 
corresponds  to  the  list  you  want.  Then  write  a  file  of  imprecise  citations  using  the 
Save  Citations  command. 

To  add  to  an  existing  list,  use  the  Load  from  File  command  to  recreate  the  list  in 
BiblioText’s  collection,  and  repeat  the  steps  for  making  a  new  list.  Alternately  (and 
more  conveniently),  edit  the  list  with  your  text  editor,  use  BiblioText  to  locate  the  ref. 
you  want  to  add,  use  BiblioText’s  Make  Citation  command  to  create  a  new  citation,  and 
finally  use  SunView’s  selection  service  to  copy  the  citation  string  into  the  subject  list  file. 

You  can  now  add  comments  to  each  list,  in  the  form  of  general  text  around  the  cita¬ 
tion  strings.  This  document  amounts  to  the  beginning  of  an  annotated  bibliography,  and 
you  can  prepare  it  for  typesetting  as  much  as  seems  appropriate. 

To  browse  the  contents  of  a  list,  use  BiblioText’s  Load  from  File  command  to 
extract  the  cited  refs.  You  have  several  choices  for  producing  printed  copies  of  these 
lists,  depending  on  how  you  format  the  files.  One  convenient  approach  is  to  hide  each 
citation  string  in  a  troff  comment,  as  described  in  Section  3.2,  and  then  use  bib  with  the  -f 
option  as  a  preprocessor  to  troff.  This  causes  each  citation  to  be  replaced  in  the  format¬ 
ted  output  with  the  relevant  reference  information  extracted  from  your  bibliographic 
database.  As  mentioned  in  Section  6.2,  you  might  develop  a  special  formatting  style  for 
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this  application,  printing  out  the  contents  of  fields  like  %W  and  %X  that  bib  normally 
ignores. 

This  third  organization  has  drawbacks  too,  but  fewer  than  the  first  two.  And  these 
drawbacks  are  the  ones  inherited  from  the  bibliographic  database  model.  For  example, 
imprecise  citations  in  a  subject  list  can  (like  a  citation  in  any  document)  become  invalid 
as  you  add  new  refs,  to  your  database. 

6.4.  Library  Management 

Closely  related  to  management  of  your  bibliographic  reference  data  is  the  need  for 
physical  management  of  the  documents  you  own.  If  you  organize  your  database 
appropriately,  BiblioText  can  help  manage  your  personal  library.  In  particular, 
BiblioText  can  help  with  three  tasks. 

•  Given  a  particular  ref.  in  your  bibliographic  database,  determine  who  owns  a  copy  and 
exacdy  where  can  it  be  found. 

•  Print  a  “shelf  list”  containing  all  the  documents  you  own  of  a  particular  type  (e.g. 
technical  books). 

•  Keep  a  circulation  list  of  documents  you’ve  loaned  to  colleagues. 

There  are  two  general  approaches  you  might  take  to  organizing  your  data  for  library 
management,  a  single-level  scheme  using  the  %W  field,  and  a  two-level  scheme  using 
location-based  raw  ref.  files  in  addition  to  the  %W  field. 

The  %W  Field 

Most  bibliographic  database  formats  reserve  the  %W  field  for  location  information , 
even  though  none  of  the  standard  tools  support  this  field  directly.  BiblioText  makes  this 
field  visible,  and  you  can  put  it  to  use  for  library  management. 

The  simplest  approach  is  to  reserve  a  specific  word  (say  mlvdv)  and  add  the  line 


%W  mlvdv 


to  the  refs,  for  every  document  you  own.  When  you  locate  a  ref.  during  a  session  with 
BiblioText,  and  you  want  to  discover  its  physical  location,  turn  on  Verbose  Display  mode 
to  see  the  value  of  the  %W  field.  To  extract  from  your  database  a  list  of  the  documents 
you  own,  use  the  Keyword  Lookup  command  with  the  keyword  mlvdv  (assuming,  of 
course,  that  you  have  included  the  %W  field  in  your  indexing). 

When  you  add  a  ref.  to  your  database  for  a  document  you  don’t  own,  you  can  record 
other  information  in  the  %W  field  to  help  you  remember  where  it  can  be  found.  For 
example,  you  might  use  a  library  call  number  or  the  name  of  a  colleague  from  whom  you 
borrowed  the  document. 

If  your  library  is  so  large  that  locating  particular  documents  can  be  a  problem,  you 
can  refine  further  the  keywords  you  add  to  the  %W  fields,  perhaps  reflecting  different 
physical  collections  within  your  library.  For  example,  you  might  use  keywords  like  mlv- 
file,  mlv-cs-book,  and  mlv-tr  to  correspond  to  a  filing  cabinet,  technical  bookshelf,  and 
technical  report  shelf  respectively. 
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If  you  use  BiblioText  to  browse  databases  belonging  to  several  colleagues,  and  not 
all  of  them  use  %W  fields,  you  can  still  determine  the  origin  of  a  particular  ref.  by  turn¬ 
ing  on  Show  Sources  mode.  In  this  mode,  BiblioText  annotates  each  displayed  ref.  with 
the  name  of  the  raw  data  file  from  which  the  raw  ref.  was  extracted.  This  is  usually 
enough  information  to  determine  the  owner  of  the  database. 

One  drawback  to  the  single-level  approach  is  the  extra  storage  required  for  a  %W 
field  in  every  ref.  Another  drawback  was  alluded  to  earlier,  the  likelihood  of  keyword 
collision  when  keywords  are  truncated  to  6  characters  for  indexing.  It  is  difficult  to 
maintain  a  collection  of  keywords  that  are  both  meaningful  and  unique  in  the  first  6  char¬ 
acters,  when  mixed  in  with  all  the  other  keywords  in  your  database.  Of  course,  you  can 
index  with  more  than  6  characters,  but  this  increases  the  size  of  your  indexes. 

Location-based  Raw  Ref.  Files 

A  more  general  approach  to  library  management,  and  one  that  scales  better,  is  to 
adopt  a  two-level  organization.  First,  structure  the  raw  ref.  files  in  your  database  to 
reflect  the  physical  arrangement  of  your  library.  Within  that  organization,  use  %W  fields 
when  appropriate  for  additional  information. 

Start  by  creating  a  file  of  raw  refs,  corresponding  to  each  group  of  documents  you 
own,  and  name  each  file  suggestively.  For  example,  books  on  your  technical  shelf  might 
be  in  the  file  "/bib/tech.book.ref,  papers  in  your  filing  cabinet  might  be  in  the  file 
"/bib/file. ref,  and  technical  reports  on  a  separate  shelf  might  be  in  the  file  /bib/tr.ref. 

Create  also  a  separate  file  for  each  major  collection.  A  collection  might  be  the 
proceedings  of  a  conference,  a  collection  of  reprints,  a  class  reader,  or  any  other  physical 
group  that  contains  multiple  bibliographic  entities.  Develop  a  naming  convention  for 
these,  too;  for  example,  articles  in  the  recent  conference  on  hypertext  might  reside  in  the 
file  "/bib/hype rtext.87. ref.  Judicious  use  of  the  macro  facility  will  help  you  keep  these 
files  compact.  For  example,  a  ref.  in  a  collection  might  appear  in  the  file  as: 


%A  Jef  Raskin 

%T  The  Hype  in  Hypertext:  A  Critique 
%J  HYPERTEXT87 
%P  325-330 


Here  the  macro  HYPERTEXT87  expands  into  several  fields  that  describe  the  conference. 

Finally,  maintain  all  of  your  raw  ref.  files  in  one  directory  and  index  them  together. 
Use  a  Makefile  to  automate  some  of  the  management,  as  suggested  in  earlier  sections. 

During  browsing,  you  can  discover  the  location  of  a  ref.  by  turning  on 
Show  Sources  mode,  since  the  name  of  the  file  now  encodes  this  information.  Further¬ 
more,  each  raw  ref.  file  is  itself  a  “shelf  list”  for  part  of  your  library.  To  print  a  shelf 
list,  use  any  of  the  techniques  described  earlier  for  printing  a  nicely  formated  version  of  a 
raw  ref.  file. 

Within  each  group  (or  file),  adopt  an  appropriate  strategy  for  recording  additional 
location  information  in  the  %W  field  as  needed.  For  example,  in  a  file  containing  confer¬ 
ence  proceedings,  the  %P  field  containing  page  numbers  will  suffice;  no  additional 


-31  - 


BiblioText 


6.  How  to  Use  BiblioText 


information  is  necessary.  In  a  file  containing  technical  books,  where  the  corresponding 
shelf  is  sorted  by  author,  the  last  name  of  the  first  author  will  suffice;  again,  no  additional 
information  is  necessary.  On  the  other  hand,  in  a  file  containing  a  bound  collection  of 
reprints,  you  may  want  to  add  %W  fields  with  page  numbers,  since  the  %P  fields  will 
contain  page  numbers  only  from  the  original  source  of  each  article.  Use  the  %W  field 
also  for  exceptions  to  your  standard  organizing  scheme,  for  example,  when  a  reprint  is 
filed  under  the  second  author’s  name.  Another  use  for  %W  is  to  record  a  library  call 
number. 

Using  this  organization,  you  won’t  need  the  %W  field  often,  but  when  it  is  present, 
BiblioText  will  notify  you  with  [%W]  in  the  viewer.  Turn  on  Verbose  Display  mode 
when  you  want  to  see  the  additional  %W  field  information. 

As  a  final  organizational  refinement,  consider  keeping  your  ref.  files  sorted  in  an 
order  that  reflects  their  physical  arrangement.  For  example,  a  shelf  of  technical  books 
might  be  sorted  by  author,  but  a  shelf  of  technical  reports  might  be  sorted  first  by  institu¬ 
tion  and  then  by  report  number.  Add  rules  to  your  makefile  that  use  sortbib  to  keep  files 
sorted  as  you  add  new  refs. 

An  important  part  of  library  management  is  to  track  circulation.  Rather  than  anno¬ 
tate  the  database  directly  with  circulation  data,  at  the  cost  of  extra  index  rebuilding,  use 
BiblioText  to  maintain  a  circulation  list.  This  is  just  a  variant  on  the  annotated  bibliogra¬ 
phy  (or  annotated  subject  list)  described  earlier.  Keep  a  file  of  imprecise  citations,  along 
with  notes  about  when  and  to  whom  they  were  loaned. 

6.5.  General  Browsing 

The  structure  of  your  data  is  as  rich  as  you  choose  to  make  it,  and  if  you  use  your 
database  for  the  other  tasks  described  in  this  section,  it  will  be  quite  rich.  BiblioText 
allows  you  to  browse  this  information  structure  as  an  extended  hypertext  document,  with 
all  the  advantages  that  have  been  claimed  for  the  hypertext  model.  This  section  discusses 
a  few  aspects  of  this  relatively  open-ended  task. 

Explicit  Relationships 

Once  you  begin  to  view  your  data  as  hypertext,  you  will  begin  to  add  links  that 
aren’t  strictly  required  for  the  more  specific  tasks  discussed  earlier.  These  links  can  cap¬ 
ture  important  relationships  that  you  have  uncovered  while  reading  and  thinking;  these 
relationships  can  themselves  carry  information. 

Most  kinds  of  explicit  links  have  been  discussed  in  earlier  sections.  For  example, 
file  links  can  record  the  relationship  between  a  ref.  and  your  comments,  a  colleague’s 
comments,  the  abstract,  or  other  supporting  material.  If  it  is  important  to  identify  the 
subject  lists  (see  above)  to  which  a  ref.  belongs,  file  links  can  record  these  relationships 
too.  BiblioText’s  Follow  <Link>  command  makes  it  convenient  to  traverse  from  a  ref.  to 
a  linked  file. 

Imprecise  citations  are  links  in  the  reverse  direction,  between  a  document  file  and  a 
ref.  Uses  for  citations  include  ordinary  document  citations  for  typesetting,  and  special 
lists  of  documents  of  various  sorts:  subject  lists,  circulation  lists,  bibliographies,  and  the 
like.  BiblioText’s  Keyword  Lookup  command  makes  it  convenient  to  traverse  from  a 
citation  to  a  cited  ref. 
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You  can  use  cite  links  to  record  whatever  relationships  among  various  refs,  that  you 
find  important.  For  example,  you  might  want  to  record  that  a  technical  report  you  own 
was  condensed  and  published  as  a  journal  article.  More  generally,  you  might  want  to 
leave  a  trail  through  a  particular  body  of  work,  when  later  work  amplifies  on  the  earlier. 
Since  you  can  name  links  arbitrarily,  these  kinds  of  links  can  themselves  contain  useful 
information.  BiblioText’s  Follow  <Link>  command  makes  it  convenient  to  traverse  from 
a  ref.  to  a  linked  ref. 

Implicit  Relationships 

During  browsing,  you  can  also  take  advantage  of  the  general  indexing  mechanism 
to  discover  relationships  that  you  haven’t  explicitly  recorded.  For  example,  you  might 
discover  an  interesting  ref.  and  wonder  what  else  a  particular  author  has  written.  Select 
the  author’s  name  in  BiblioText’s  viewer  and  use  the  Keyword  Lookup  command  to  col¬ 
lect  more  refs,  from  the  database. 

The  same  technique  works  for  project  names,  system  names,  keywords,  and  any¬ 
thing  else  that  you  can  discover  during  browsing.  The  indexing  mechanism  is  neces¬ 
sarily  approximate,  so  you  will  often  discover  irrelevant  refs,  among  those  you  locate. 
This  kind  of  unstructured  searching  doesn’t  scale  up  for  large  libraries,  but  it  works  well 
for  typical  personal  and  shared  group  libraries. 

Extended  Browsing  Domains 

If  possible,  locate  bibliographic  databases  that  belong  to  colleagues  with  similar 
interests,  and  configure  your  BiblioText  environment  to  read  those  databases  too.  Then, 
when  browsing,  you  might  discover  a  title  that  looks  interesting,  but  which  you  don’t 
own.  Select  the  last  name  of  an  author  (or  the  name  of  a  project  or  system)  and  use  the 
Keyword  Lookup  command.  Among  the  results,  you  might  find  that  a  colleague  owns 
something  closely  related  by  the  same  author  (or  about  the  same  project  or  system). 

Extend  the  range  of  your  browsing  even  further  by  importing  bibliographic  data 
from  outside  sources  and  converting  it  to  bib  format  for  browsing.  The  necessary 
conversion  will  depend  on  the  source,  but  often  can  be  automated.  You  can  then  browse 
quickly  through  new  arrivals,  simply  by  loading  the  file  of  converted  raw  refs.  If  you 
keep  archives  of  imported  data,  distribution  lists  for  example,  you  might  keep  separate 
indexes  for  all  of  these  for  later  browsing. 


7.  Themes  and  Issues 

BiblioText  is  a  byproduct  of  ongoing  research  in  the  design  of  software  tools  for 
personal  working  environments.  This  section  briefly  mentions  some  of  the  issues 
addressed  during  this  research;  some  are  discussed  more  fully  in  [Yan88]. 

Task  Oriented  Design  and  Coevolution 

The  creation  and  subsequent  three-year  evolution  of  BiblioText  exemplifies  several 
important  ideas  in  the  study  of  how  programs  get  designed.  The  first  prototype  of 
BiblioText  was,  and  continues  to  be,  an  example  of  task-oriented  design.  It  was  built  to 
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get  a  particular  job  done,  in  a  particular  existing  niche,  and  not  to  create  a  new  computa¬ 
tional  metaphor. 

As  BiblioText  evolves,  it  has  become  clear  that  the  notion  of  niche  must  be  broadly 
defined.  The  design  and  evolution  have  both  responded  to  environmental  factors  that 
include,  among  others,  the  computational  environment  (hardware,  operating  system,  win¬ 
dow  manager),  preexisting  sets  of  tools  and  data  (like  bib  and  the  established  databases 
in  bib  format),  and  the  skills  and  expectations  of  potential  users. 

Furthermore,  these  environmental  influences  are  all  in  constant  change.  Hardware 
speed  has  increased,  three  different  releases  of  the  window  manager  have  arrived,  a  new 
database  format  was  designed,  and  the  user  community  has  become  more  accustomed  to 
certain  window/mouse  interactive  styles.  Even  the  first  experimental  prototype  of 
BiblioText  was  a  response  to  this  kind  of  change;  it  was  conceived  of  as  an  interactive, 
window/mouse  based  version  of  the  batch  program  lookup. 

Finally,  the  history  of  BiblioText  shows  that  its  presence  in  local  working  environ¬ 
ments  has  influenced  how  people  do  their  work,  leading  in  turn  to  more  ideas  for 
enhancements  to  BiblioText.  It  is  through  this  kind  of  coevolution,  by  being  useful  to 
some  community  at  every  step,  that  small  useful  systems  often  grow  into  larger  useful 
systems. 

Principled  User-Interface  Design 

At  one  point  during  its  history  BiblioText  was  the  subject  for  an  experiment  in  the 
design  of  user  interfaces.  Part  of  that  work  involved  the  construction  of  several  explana¬ 
tory  models;  sections  5  and  6  of  this  document  inherited  some  of  these.  Another  part  of 
that  work  was  a  principled  redesign,  following  cognitive  strategies  like  those  discussed  in 
[N0D86].  After  an  empirical  evaluation  by  some  new  users,  the  results  of  the  whole  pro¬ 
ject  were  used  to  prepare  yet  another  redesign  of  the  user  interface. 

BiblioText’ s  user  interface  has  continued  to  evolve  since  the  experimental  redesign, 
but  it  has  always  been  a  vehicle  for  the  exploration  of  user-interface  themes,  as  well  as  a 
useful  tool. 

Limitations  and  Future  Prospects 

Although  BiblioText  could  undoubtedly  continue  to  evolve  and  improve  as  it  has  in 
the  past,  two  particularly  troublesome  sets  of  limitations  stand  in  the  way. 

The  first  problem  is  the  bibliographic  database.  The  data  model  upon  which  it  is 
based  was  never  intended  to  support  applications  of  the  size  and  complexity  of  those  dis¬ 
cussed  here.  For  example,  important  non-bibliographic  entities  (such  as  journals, 
authors,  and  the  like)  are  not  treated  as  database  objects.  Furthermore,  the  supporting 
mechanisms  do  not  scale  well  as  databases  grow.  It  is  computationally  expensive  and 
inconvenient  to  rebuild  an  index  after  any  change  to  the  raw  data. 

A  second  set  of  problems  concerns  BiblioText’s  integration  with  a  window  system 
and  with  an  editor.  BiblioText  can  now  present  only  one  document  file  at  a  time,  because 
of  implementation  restrictions  in  the  SunView  window  manager.  This  clearly  limits  its 
usefulness  as  a  general  hypertext  browser.  Furthermore,  BiblioText  presents  document 
files  in  the  SunView  editor;  this  editor  is  not  widely  used  in  this  environment,  and  is  not 


-34- 


BiblioText 


7.  Themes  and  Issues 


as  configurable  and  extensible  as  one  would  like.  The  result  is  that  most  users  of 
BiblioText  have  to  deal  with  two  different  editors. 

A  solution  to  both  problems  would  be  to  integrate  BiblioText  with  a  more  general, 
window/mouse  editing  system.  A  promising  candidate  is  Pan,  also  being  developed  as 
part  of  the  PIPER  projects  at  UC  Berkeley.  Pan  is  designed  for  language-based  and  gen¬ 
eral  structure/text  editing.  Pan  supports  more  windows,  and  is  fully  configurable  and 
extensible[BVG87].  A  second  solution,  not  exclusive  of  the  first,  would  be  to  port 
BiblioText  from  SunView  to  a  window  manager  that  supported  more  windows  per  pro¬ 
cess,  such  as  NeWS  or  X. 
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